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Paradox saves you from 
future shock 


Trends for the future with Paradox 




















Paradox 386 allows users to 
take advantage of 16 Megabytes 
of Memory on a 386 machine. 
This allows Paradox users to 
work with databases that could 
in the past only be handled 
by minicomputers and 
mainframes. 


How to make your network network 
To run Paradox 2.0 or the Paradox Network Pack on a network you need: 


* Novell with Novell Advanced Netware version 2.0A or higher 

* 3Com 3Plus with 3Com 3+ operating system version 1.0, 1.1 or higher 

* IBM Token Ring or PC Network with IBM PC Local Area Network Pro- 
gram version 1.12 or higher 

* Torus Tapestry version 1.4 or higher 

* AT&T Starlan Network with AT&T PC 6300 Network Program version 

* Other network configurations that are 100% compatible with DOS 3.1 
and one of the listed networks 

System Requirements for Single User: 

* DOS 2.0 or higher 

* IBM® PS/2 and PC, Compag® PC families and other 
100% compatibles 

¢ 512K RAM 

* Two disk drives, 3%-inch and 5%-inch supported 

¢ Compatible monochrome, color, or EGA monitor with adapter 
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Source: Software Digest* 























Your investment today in 
Paradox applications is pro- 
tected as new hardware and 
operating systems are used in 
your company. Paradox 2.0 
applications will run un- 
changed on Paradox 386, 
Paradox OS/2, Paradox Unix 
and Paradox SOL! All versions 
of Paradox will be completely 
application and menu compati- 
ble. Paradox SQL will allow 
access to remote databases via 
SQL. Users will just type in a 
query as they normally would, 
and Paradox will translate that 
Query to SOL. 





44 Paradox 2.0 will 
do for the LAN what the 
spreadsheet did for the PC 


David Schulman, 
Bendix Aerospace 99 





System Requirements for the Network Workstation: 

* DOS 3.1 or higher 

¢ 640K RAM 

¢ Any combination of hard, floppy, or no disk drives 

* Compatible monochrome, color, or EGA monitor with adapter 

Optional Equipment: 

* EMS and EEMS Boards: AST RAMpage Board,” Intel Above Board® 
or other expanded memory adapters 

* Printers: Compatible dot matrix, letter quality, or laser printer 


“Reprinted with permission by Software Digest from its July 1987 report 
covering 12 relational database programs. 


Paradox makes your 
network run like 
Clockwork 


Paradox is just as valuable 
to multi and network users as 
it is to single users. It runs 
smoothly, intelligently and so 
transparently that multiusers 
can access the same’ data at the 
same time—without either 
being aware of each other or 
getting in each other's way. It 
works exactly the same way 
whether you're flying solo or 
as part of the crew. 





4&@ Anyone who hasn’t 
seen the network version 
of Paradox should take a 
look. Ansa has dramati- 
cally advanced the state 
of the art in multiuser 
network databases 


Phil Lemmons, 
BYTE 


Paradox was a delight 
to use, both as a stand- 
alone product and from 
a local area network 
server. 


Don Crabb, 
InfoWorld b | b | 





t Test was designed and executed by NSTL. A 1,000-record and a 
10,000-record file were joined. A short text field from the 1,000-record 
file and a numeric field from the 10,000-record file were selected (using 
the 1,000-record file indexes). The short text field was grouped and 
sorted in ascending order, the numeric field was subtotaled for each 
group, and the results output to a null printer. Test times from the last 
keystroke on the command sequence until return of program control 
were recorded and averaged. 


Paradox is a registered trademark of Ansa Software. Ansa is a Borland International 
company. Other brand and product names are trademarks or registered trademarks of 
their respective holders. Copyright ©1988 Borland International, Inc. Bl 1205 
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aradox is once again — 
the top-rated program, 


with the latest version 
scoring even higher than last 
year’s top score.”’ (Software 
Digest’s July 1987 Ratings 
Report—an independent com- 
parative ratings report for 
selecting IBM PC Business 
software). 

All tests for the Ratings 
Report were done by the pres- 
tigious National Software Test- 
ing Laboratory, Philadelphia, 
PA, and the message is crystal 
clear: there is no better rela- 
tional database manager than 
Paradox. 

NSTL tested 12 different 
programs and amongst other 
results, discovered that 
Paradox is 3 times faster than 
dBASE; 6 times faster than 
R:BASE on a two-file join 
with subtotals test. 


Paradox does the 
impossible: combines 
ease-of-use with power 
and sophistication 

Even if you're a beginner, 
Paradox is the only relational 
database manager that you 
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can take out of the box and 
begin using right away. 

Because Paradox employs 
state-of-the-art artificial intel- 
ligence technology, it does 
almost everything for you— 
except take itself out of 
the box. 

If you've ever used 1-2-3° 
or dBASE® you already know 
how to use Paradox. It has 
Lotus-like menus, and 
Paradox documentation 
includes “A Quick Guide to 
Paradox for Lotus users,’ and 
‘A Quick Guide to Paradox 
for dBASE users.’ 
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Source: Software Digest* 


Ideal programs have high levels of both 
power and usability. Programs plotted in 
the upper righthand portion of the diagram 
above come Closest to achieving that ideal. 
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Why Parada 


44 Paradox still offers 
superior import/export 
facilities using Lotus 
1-2-3, dBASE, ASCII 
and other file types. It 
transfers between formats 
with stunning speed 

Rusel DeMaria, PC Week 9¥ 


Paradox responds 
instantly to “Query- 
by-Example” 

The method you use to ask 
questions is called Query-by- 
Example. Instead of spending 
time figuring out how to do 
the query, you simply give 
Paradox an example of the 
results you re looking for. 
Paradox picks up the example 
and automatically seeks the 
fastest way of getting the 
answer. Paradox, unlike other 
databases, makes it just as 
easy to query multiple tables 
simultaneously as it is to 
query one. 







RATINGS KEY 
(On a scale of 0 to 10) 
Overall Evaluation 
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Paradox: the new 
corporate standard 


Paradox automatically 
updates your data and 
lets you control access 
to information 

In Co-Kdit’’ mode, changes 
made by anyone are automati- 
cally updated to everyone. You 
can pre-set a Screen-Refresh’’ 
interval to occur anywhere 
from 1-second to 1-hour inter- 
vals. (If you don’t make a pre- 
set choice, Paradox automati- 
cally updates every 3 seconds 
so that your screen always 
shows you updated data). 

While Paradox 2.0 lets 
everyone share and update 
information simultaneously, 
you can configure it to keep 
secrets secret. 

You can restrict others’ rights 
in a variety of ways with safe- 
guards protecting confidential 
files and/or giving someone 
“Read Only”’ rights which is 
to allow View,’’ but prevent 
“Change.’’ The Paradox tech- 
nique—automatic file and 
record locking—ensures data 
accuracy and integrity in any 
multiuser environment. 


For a brochure or 
the dealer nearest you 
call (800) 543-7543 


PARADOX 





A Borland Company 





44 With Version 2.0, 
Paradox becomes a sophis- 
ticated multiuser product 
that boasts an impressive 
selection of data-protection 
features and password- 
security levels 


Rusel DeMaria, 
PC Week 99 





Get serious support for 
serious Paradox applica- 
tion programming 

When you subscribe to the 
Paradox Developer’s Resource 
Program (PDRP), you get all the 
resources and support you need 
for sophisticated Paradox appli- 
cation development: unlimited 
access to our toll-free PAL 
programmers support line; the 
Paradox Developer’s Toolkit: a 
subscription to Turbo Technix, 
Borland’s bi-monthly technical 
magazine; and a 20% discount 
on the Paradox User’s Journal 
published by the Cobb Group. 

Call our Customer Service 
Department at (408) 438-8400 
for your free PDRP information 
kit with all the details. 
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Interlocking Pieces: 
Blaise and 
Turbo Pascal. 


Whether you're a Turbo Pascal expert or a novice, you can benefit from using professional tools 
to enhance your programs. With Turbo POWER TOOLS PLUS™ and Turbo ASYNCH PLUS 


Blaise Computing offers you all the right pieces to solve your 4.0 development puzzle. 


Compiled units (TPU files) are provided so each package is ready to use 
with Turbo Pascal 4.0. Both POWER TOOLS PLUS and ASYNCH PLUS 
Ss use units in a clear, consistent and effective way. If you are familiar 

* got with units, you will appreciate the organization. If you are just getting 
| started, you will find the approach an illustration of how to construct 
and use units. 


#POWER TOOLS PLUS isa library of over 180 powerful functions 
and procedures like fast direct video access, general screen 
handling including multiple monitors, VGA and EGA 50-line 
and 43-line text mode, and full keyboard support, including 
the 101/102-key keyboard. Stackable and removable win- 
dows with optional borders, titles and cursor memory 
. provide complete windowing capabilities. Horizontal, ver- 
F tical, grid and Lotus-style menus can be easily incorporated 
into your programs using the menu management routines. 
You can create the same kind of moving pull down menus 
that Turbo Pascal 4.0 uses. 


Control DOS memory allocation. Alter the Turbo Pascal heap 

size when your program executes. Execute any program from 

within your program and POWER TOOLS PLUS automatically 

. compresses your heap memory if necessary. You can even force 
. the output of the program into a window! 


Write general interrupt service routines for either hardware or 

software interrupts. Blaise Computing’s unique intervention 

code lets you develop memory resident (TSRs) applications 

that take full advantage of DOS capabilities. With simple pro- 

cedure calls, “schedule” a Turbo Pascal procedure to execute 
when pressing a “hot key” or at a specified time. 
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~ @ASYNCH PLUS provides the crucial core of hardware interrupts 

needed to support asynchronous data communications. This package offers 
simultaneous buffered input and output to both COM ports, and up to four 
ports on PS/2 systems. Speeds to 19.2K baud, XON/XOFF protocol, hard- 
ware handshaking, XMODEM (with CRC) file transfer and modem control 
are all supported. ASYNCH PLUS provides text file device drivers so you 
can use standard “ReadIn” and “Writeln” calls and still exploit interrupt-driven 
communication. 


The underlying functions of ASYNCH PLUS are carefully crafted in assembler 
and drive the hardware directly. Link these functions directly to your application 
or install them as memory resident. 


Blaise Computing products include all source code that is efficiently crafted, 
readable and easy to modify. Accompanying each package is an indexed 
manual describing each procedure and function in detail with example 
code fragments. Many complete examples and useful utilities are 
included on the diskettes. The documentation, examples and 
source code reflect the attention to detail and commitment to 
¥ technical support that have distinguished Blaise Computing over 
the years. 


Designed explicitly for Turbo Pascal 4.0, Turbo ao 
» POWER TOOLS PLUS and Turbo ASYNCH ee amet 
™ PLUS provide reliable, fast, professional routines — T YES! MF 59 


the right combination of pieces to put your Turbo Pascal, En 
puzzle together. Complete price is $129.00 each. 8 


rN 
WT 


BLAISE COMPUTING INC. 


2560 Ninth Street, Suite 316 Berkeley, CA 94710 (415) 540-5441 
CIRCLE NO. 102 ON READER SERVICE CARD 








field control with instant screen acce 
_ for Turbo Pascal 4.0, soon for C an 
.. Turbo C TOOLS - 
_ Full spectrum of general se 
tions including: windows; 
_ resident applications; i 
tines; intervention code; 
access for fast screen hand 


Microsoft C 5.0 and QuickC. 
-ASYNCH MANAGER © 
COM ports. I/O buffers up to’ 


_ XOFF; up to 9600 baud: moder 
~XMODEM file transfer. For Mic 


: 2 _ For MS-Pascal. 
‘ KeyPilot’ a 

- “Super-batch” program 
~ which can invoke progra 
- demonstration programs; 
‘NEW VERSION! Progra: 


-. different languages; 


screens; | 


































d BASI 


CTOOLISPLUS ~~ 81 
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support; direct screen access; DOS fi 
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Object-Oriented Programming and Database Design 18 
by Jacob Stein 

Object-oriented programming has been gaining acceptance in 
the last few years. In this article, Jacob gives an introduction 
to object-oriented programming in general, a description of a 
specific object-oriented language (OPAL), and some example 
problems that are particularly well suited to object-oriented 
solutions. 

Writing Custom Display Fonts 36 
by Andrew J. Chalk 

Andrew describes a TSR he’s written for the EGA that auto- 
matically replaces the standard screen font with a resident 
custom font. 

Threaded Binary Trees a2 
by James Mathews 

Textbook discussions of threaded binary trees are almost 
always accompanied by source code in Pascal, aimed at the 
university student. In this article, Jim describes some routines 
he developed for traversing and managing these trees in 
Microsoft C. 


Navini 


EXAMINING ROOM 
coordinated by Ron Copeland 
Products examined from the programmer's perspective. This 
month's offering includes a detailed review of Borland’s Turbo 
Pascal 4.0, and a quick look at Microsoft's CodeView debugger. 


COLUMNS 


116 


TO THE MACS 

by Stan Krute 

Stan winds up the CDEF project he began in the January 
column, and talks about several products. 


STRUCTURED PROGRAMMING 

by Kent Porter 

Not all problems are polite enough, or trivial enough, to 
shoehorn into the PC’s 64K segments. This month Kent shares 
his techniques for handling large data arrays in Turbo Pascal. 


PROGRAMMER’S 
SERVICES 


EDITORIAL 


by Tyler Sperry 
RUNNING LIGHT 
by Tyler Sperry 
LETTERS 


ADVERTISER INDEX: $1 
Where to go for more infor- 
mation on products. 

OF INTEREST 128 
Product news for the pro- 
gramming community. 


by Joe Sikoryak 
SWAINE’S FLAMES 
by Michael Swaine 
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VOLUME 13, ISSUE 3 


About the Cover 

If nothing else, object-oriented 
languages have gotten a rap for 
being abstract and not as effi- 
cient as needed for real-world 
problems. This month's lead 
article discusses  object-ori- 
ented programming languages 
and some real-world problems 
where the _ object-oriented 
approach excels. Sometimes all 
you need are the right tools 
(like data hiding and _ inheri- 
tance) and a little “blue sky” 

thinking. : 


Next Issue 
The annual AI issue, with 
language hacking techniques 
for fanciers of LISP and 
PROLOG, a review of Objective- 
C, and all the usual foolishness. 
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Nobody ever said programming 
PCs was supposed to be easy. 

But does it have to be tedi- 
ous and time-consuming, too? 

Not any more. 

Not since the arrival of 
the remarkable new program 
in the lower right-hand corner. 

Which is designed to save 
you most of the time youre 
currently spending searching 
through thebooks and manuals 
on the shelf above. 

The Norton On-Line Pro- 
grammer’s Guides are a quar- 
tet of pop-up reference 
packages that do the same 
things in four different 
languages. 

Each package consists of 
























two parts: A memory-resident instant 
access program. And a comprehensive, 
cross-referenced database crammed 
with just about everything you need to 
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Instant Access Program 

= Memory-resident—uses just 71K. 

® Full-screen or moveable half-screen 
view, with pull-down menus. 

# Auto lookup and searching. 

® Tools for compiling your own databases. 


ASSEMBLY (600K of data) 

@ DOS Service Calls: All INT 21h services, 
interrupts, error codes, FCB and PSP 
fields, standard handles and more. 

# ROM BIOS Calls: All ROM calls plus low 


M usage. 
® Instruction Set: All 8088/86 instructions, 


addressing modes, flags, bytes per 
instruction, clock cycles and more. 

= MASM: Pseudo-ops and assembler 
directives. 

® Tables: ASCII chart, line-drawing charts, 
keyboard scan codes and more. 


BASIC (270K each database) 
= IBM BASICA, Microsoft QuickBASIC 
and TurboBASIC. 
= Statements and Functions: Describes all 
statements and built-in library functions. 


Designed for the IBM* PC, PC-AT and DOS compatibles. Available at most software 
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know to program in your 
favorite language. 


= GUIDES DATA 









pro 





@ Tables: Line-drawing characters, ASCII 
chart, keyboard codes, error codes, 
operators, etc. 


C (600K each database) 

® Microsoft C and Turbo C: Describes 
language, including statements, 
operators, data types and structures. 

® Library Functions: Detailed 
descriptions of all functions, from 
abort () to write (). 

= Preprocessor Directives: Describes 
commands, usage and syntax. 

® Tables: ASCII chart, line-drawing 
characters, keyboard codes, error codes, 
operators, etc. 


PASCAL-— Turbo (360K of data) 

= Language: Describes statements, 
syntax, operators, data types and 
records. 

@ Library: Describes the library 
procedures and functions. 

@ Tables: ASCII chart, line-drawing 
characters, keyboard codes, error codes, 
reserved words, etc. 





(If you don’t believe us, you might want 
to take a moment or two to examine the 
data box you just passed.) 

You can, of course, find most of this 
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information in the books and manuals 
on our shelf. 

But Peter Norton—who’s written a 
few books himself—figured you'd rather 
have it on your screen. 

In seconds. 

In either full-screen or moveable half- 
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A Guides reference summary 
screen (shown in blue) pops up on 
top of the program you're worki 
on (shown in green). 


Summary data expands on 
command into extensive detail. 
ng And you can select from a wide 
variety of information. 


screen mode. 

Popping up right next to your work. 
Right where you need it. 

This, youre probably thinking, is pre- 
cisely the kind of thinking that pro- 
duced the classic Norton Utilities. 

And youre right. 

But even Peter Norton can’t think of 








everything. 

Which 1s why there’s a built-in com- 
piler for creating databases of your own. 

And why all Guides databases are 
compatible with the instant access pro- 
gram in your original package. 

So youcan add more languages without 
spending a lot 
more money. 

‘To get 
more informa- 
tion, call your 
dealer. Or 
call Peter 
Norton at 
1-800-451- 
0303 Ext. 40. 

And ask 
for some 
guidance. 
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FORUM 


EDITORIAL | 


Object Lessons 


ecently I attended Microsoft's 
Bovina Systems Software Semi- 
nar. This is less a seminar in the 
academic sense than a carefully or- 
chestrated presentation for the 
press, a gathering where Micro- 
softians like Bill Gates and Steve Ball- 
mer take turns at a podium and 
argue over exactly when OS/2 will 
take over the known universe. There 
were also presentations on future 
enhancements to DOS, the OS/2 LAN 


and SOL servers, future developer 


goodies, etc. 

Bill Gates remarks on program- 
ming languages really got me think- 
ing, though. He spent a fair bit of 
time explaining to an audience of 
industry analysts and press people 
about these things called “objects” 
and how they were the coming 
thing in programming. This is a view 
I quite agreed with. The increasing 
complexity of environments like the 
Mac Toolbox and the OS/2 Presenta- 
tion Manager cry out for new pro- 
gramming tools and methods. Lan- 
guage packages like Actor and Small- 
talk/V have the potential (in their 
inevitable protected mode versions) 
to be the next wave in program- 
ming. : 

But Bill Gates wasn't talking about 
Smalltalk or Actor. 

The people at Microsoft, you see, 
have a language division that’s ex- 
pected to turn a profit. It isn’t their 
job to convert the world to new 
languages, it’s to sell language pack- 
ages. Preferably more than Borland 
does. 

So when asked how Microsoft was 
going to address the topic of object- 
oriented programming with its lan- 
guages, Bill Gates wasn’t interested 
in weirdo languages like Smalltalk; 
he talked about adding object-ori- 
ented extensions to existing Micro- 
soft languages: C and BASIC. 

Object-oriented BASIC! What a con- 
cept! Soon beginners will be able to 
add modular meatballs to their spa- 
ghetti code. My mind boggled with 


the possibilities and almost missed 
the follow-up from Gates: there's no 
promise of when these extensions 
will appear, or in what form. ANSI C 
is still the chosen language, and con- 
verting to C+ + seems unlikely. 

The next day on the plane home 
I was still pondering the notion of 
what—for want of a better name— 
I'm calling OOBASIC (pronounced 
“uh-oh BASIC”). The question I was 
wrestling with is non-trivial: how 
much of the increased sales of pro- 
gramming languages is based on ad- 
vances in programming technology, 
and how much is simply improved 
marketing? It’s a difficult question. 
After all, Borland had a Modula-2 
compiler years ago and dumped it. 
Yet the same company has managed 
to make money on PROLOG by 
hyping it as ‘the language of artifi- 
cial intelligence.” 

I've spent some time considering 
Bill Gates’ opinion that no new lan- 
guages will make an impact in the 
years to come, and I’m still not con- 
vinced. It seems to me that the new 
paradigms and new environments 
will demand new approaches, not 
patches on old languages. The folks 
at the Whitewater Group and Digi- 
talk and other companies seem to 
be able to do quite well marketing 
solutions rather than trying to jump 
on the bandwagon and sell yet an- 
other ANSI C compiler. Just maybe 
they're on to something. And maybe 
object-oriented extensions to older 
languages are really a step back in- 
stead of forward. The next year or 
so will tell. 

In the meantime, I'll be spending 
my evenings exploring Smalltalk and 
other languages, examining new para- 
digms, and counting myself lucky 
on the days I don’t get a press re- 
lease announcing object-oriented 
COBOL. 


Tyan Spar 


editor 
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Aztec C 


Power to go the 


distance... 


Whatever that distance might be 


From real time embedded 
applications to comprehensive 
commercial applications on 
Macintosh, IBM PC, Amiga, 
Atari, and others, Aztec C has 
earned a well-deserved reputa- 
tion as an innovative, tough to 
beat, rock-solid C development 
system. 


But don't just take our word for 
it—try it yourself. We know that 
the best way to understand what 
puts you ahead with Aztec C is 
to use it. That's why Aztec C 


systems purchased directly from 
Manx come with a 30-day, no 
questions asked, satisfaction 
guarantee. Call for yours today. 


We can also send you informa- 
tion that details the special fea- 
tures and options of Aztec C. 
Plus information on support soft- 
ware, extended technical sup- 
port options, and all of the 
services and specialized sup- 
port that you may need when 
you're pushing your software to 
the limits and... beyond. 


Host+ Target: $750 Additional Targets: $500 


Targets: 

@ 6502 family 

© 8080-8085-280-2180-64180 

© 8088-8086-80186-80286/8087-80287 
© 68000-68010-68020/68881 


Components: 

e C compiler for host and target 
e Assembler for host and target 
@ linker and librarian 

e@ Unix utilities make, diff, grep 
@ Unix vi editor 

e debugger 

© download support 








C.0.D., VISA, MasterCard, American Ex- 
press, wire (domestic and international), and 
terms are available. One and two day deliv- 
ery available for all domestic and most 


international destinations. 


Manx Software Systems 
One Industrial Way 
Eatontown, NJ 07724 


Features: 

e Complete development system 

e Fast development times 

e Prototype and debug non-specific 
code under MS-DOS 

e Compilers produce modifiable 


assembler output, support inline 
assembly, and will link with assembly 
modules 

e Support for INTEL hex, S record, and 
other formats 

e source for UNIX run time library 

® processor dependent features 

@ source for startup . 
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Aztec C is available for most micro- 
computers in three configurations: 
The Professional; The Developer; and 
The Commercial system. All systems 
are upgradable. 


Aztec C68k/Am .... Amiga 
source debugger—optional 


Aztec C68k/Mac ... Macintosh 
MPW and MAC |! support 
Aztec C86 ......... MS-DOS 


source debugger « CP/M libraries 


The following have special pricing and 
configurations. Call for details. 


Aztec C68k/At ..... Atari ST 

Aztec C80......... CP/M-80 

Aztec C65......... Apple ll & Il GS 
Standard System ............... $199 
@ C compiler 

e Macro Assembler 

® overlay linker with librarian 

@ debugger 

@ UNIX and other libraries 

® utilities 

Developer System .............. $299 
@ all Standard System features 

e@ UNIX utilities make, diff, grep 

@ UNIX vi editor 

Commercial System ............ $499 


@ all Developer features 
@ source for run time libraries 
@ one year of updates 


Aztec C is available on a thirty-day money back guarantee. Call 
now and find out why over 50,000 users give Aztec C one of the 
highest user-satisfaction ratings in the industry. 


In NJ or outside the USA, 
call 201-542-2121 


Telex: 4995812 Fax 201-542-8386 
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RUNNING LIGHT 


irst things first. 
B visas note that 
the lack of a ‘‘C Chest” 
column this month 
doesn't mean we 
don't love C anymore. 
It’s just that Allen 
Holub got involved 
with a few too many 
projects and had to 
take a vacation to de- 
compress. Allen will 
be back next month, fully recovered. 
In the interim, this issue has plenty 
of C code to keep you busy. 

Next topic: programming books. 
The floodgates have just started to 
crank open, and we're about to be 
inundated with books on program- 
ming for OS/2. Many of those books 
will be nothing more than boring 
regurgitations of the existing Micro- 
soft documentation. Happily, I have 
seen some outstanding books lately, 
books written by programmers who 
really know what's going on inside 
OS/2, and I'd like to share the good 


news. 
First up is Ed Iacobucci’s OS/2 
Programmer's Guide (Osborne 


McGraw-Hill, 1988). Iacobucci was 
the leader of the IBM OS/2 design 
team and clearly knows his stuff. 
This book is one of those (like Peter 
Norton’s excellent Programmer's 
Guide to the IBM PC) that attempts 
to give you both the massive 
amounts of information that you 
really need and yet still be readable. 
At 1,100 pages, the book certainly is 
complete in coverage, and Iacobucci 
covers the material with a simple, 
clear style. This book is obviously 
the work of someone who's spent a 
lot of time helping other program- 
mers get their programs running 
under OS/2, and wants to share his 
experience. Unlike most paperback 
computer books these days, this 
one’s a steal at $25. 

Mere recommendations aren't 
really good enough for Inside OS/2 
by Gordon Letwin (Microsoft Press, 





1988). Let me put it 
more directly: if you're 
at all serious about OS/ 
2, you must buy this 
book. Letwin was the 
chief architect for Mi- 
crosoft's OS/2 team, 
and with this book 
he’s managed to pull 
off the nearly impossi- 
ble trick of explaining 

| the inner workings of 
OS/2 along with the reasoning 
behind the architecture, while actu- 
ally making the book fun to read. If 
you're new to OS/2, reading this book 
will take weeks off your learning 
curve. It isn’t often that we're treated 
to a book this good. 

Finally, if you're still writing code 
for MS-DOS instead gearing up for 
OS/2, I'm sorry to report that you're 
probably going to spend a great deal 
of money soon. The MS-DOS Ency- 
clopedia is finally out, and it’s gener- 
ally a splendid (and massive) 
volume. Aside from the title, this 
book has nothing in common with 
the encyclopedia offered by Micro- 
soft a few years back. This is a good 
reference, designed for program- 
mers. There's coverage of the details 
of the file system, as well as articles 
on writing TSRs, device drivers and 
exception handlers, etc. There's a 
section on compatibility between 
DOS versions and OS/2, as well as 
developing for Windows. 

My only problem with the book, 
besides it’s hefty price tag of $135, is 
the dust jacket. The book was or- 
chestrated and edited by friend and 
ex-DDJ columnist Ray Duncan, but 
somehow they forgot to put his 
name on the cover of the copy I 
received. The item they did remem- 
ber is a nice bold credit for the 
foreword by Bill Gates. Funny how 
these things work out. 
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Ten Years Ago Today 

“...Pascal with extensions is a 
superior language for system program- 
ming, and we believe that it is in the- 
public interest to assist in the current 
effort of many people and institutions to 
promote wider use of Pascal in place of 
some of the earlier high level languages. 
Though Pascal may have some short- 
comings for specific applications when 
compared to specific proprietary lan- 
guages, we regard it as by far the best 
general purpose language now in the 
public domain.’—Kenneth L. Bowles 
“Status of the UCSD Pascal Project,’ DDJ, 
March 1978. 


The object of this class is. .. 

“Object-oriented programming began 
in the early 1960s with the development 
of Simula by the Norwegian Computation 
Center in Oslo, Norway. Simula was the 
first language to implement the Class 
construct. In the early 1970s, the Learning 
Research Group at Xerox Palo Alto 
Research Center began implementation 
of the Smalltalk programming envi- 
ronment. Smalltalk was the first system 
to be designed completely around the 
Class/Object concept. Many other lan- 
guages have since provided support for 
classes, object, and subclassing, including 
CLU, Ada, C+ + (an extended version of 
C), and several versions of LISP, though 
objects and classes are not as well 
integrated into these languages as they 
are in Smalltalk. The ease of exper- 
imentation with objects was one of the 
key reasons that much of the interesting 
user interface designs borrowed for 
Macintosh and Lisa were created in the 
Smalltalk system.’—Bruce Horn, DDBJ, 
October 1985. 
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ve! Introducing Turbo C 1o— 
the best optimizing compiler 
sets even better! 


The professional 
optimizing compiler 
for less than $100 
Turbo C® is a techni- 
cally superior produc- 
tion-quality compiler. 
(Borland’s equation sol- 
ver, Eureka”™, is written in 
Turbo C.) And our Turbo 
C 1.5 offers a new library 
of the highest presenta- 
tion-quality graphics in 
the industry—the kind 
you'll see in Quattro.” 





Our NEw professional Actual photograph of Turbo C graphics displayed on IBM 8514 screen.” 
spreadsheet. 
: And spectacular graph- ° Text/video functions, ¢ Sample graphics 

ics are just part of the including windows applications 

brand-new features. ¢ 43- and 50-line mode ¢ More than 100 new 

Turbo C 1.5 enhance- gidlegen functions 

ments also include: e VGA, CGA, EGA, Hercules, For professional-quality C 
i infessional-quallt and IBM 8514 support at an affordable price, no one 

4 olessional-quallty ¢ File search utility (GREP else comes close to Turbo C. 
graphics library of over : Because no one can deliver 
70 functions technical superiority like 

e A librarian that allows you = => Borland. 





to build your own object 
module libraries 


¢ Context-sensitive help for For the dealer nearest 
the language and the BORLAND you or to order, call 


library routines (800) 543-7543 


Minimum system requirements: For the BM PS/2™ and the |BM® and Compag® families of personal computers and all 100% compatibles. PC-DOS (MS-DOS) 2.0 or later. 384K. 

*Artwork metafile courtesy of Genigraphics® Corporation 

**Customer satisfaction is our main concern; if within 60 days of purchase this product does not perform in accordance with our claims, call our customer service department, and we will arrange a refund. 

All Borland products are trademarks or registered trademarks of Borland International, Inc. Other brand and product names are trademarks or registered trademarks of their respective holders. Copyright ©1987 Borland international, Inc. BI 1165B 


60-Day Money-back Guarantee** 
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It’s easy to upgrade to Turbo C 1.5! 


Just complete this coupon and mail it with payment before June 30, 1988. Or, call us at (800) 543-7543 and be ready to give our operators your name, 
credit card number, and the serial number on your Turbo C master disk. 


Turbo C 1.5 Upgrade Price $ 33.50 





Please specify diskette size O 5%” O 3%" 
Method of Payment: O VISA O MC O Check O Bank Draft 











CA and MA residents add Sales tax Credit card expiration date: / 
Shipping and handling 
In US $5.00 (Outside US add $10) 5) Cane pd a eee be Po eee Bb ed 


Total amount enclosed $ 
Must include your Turbo C serial # 
Return this coupon and the Turbo C RTL source code registration form from your Turbo Sip Adcr€SS 
C manual along with your payment by March 31, 1988 and receive your Turbo C 1.5 ci State 
upgrade for free! (No phone orders please.) ity 
Turbo C 1.5 Runtime Library Zip 

Source Code $ 150.00 


CA & MA residents add sales tax 
Price includes shipping to all US cities. 
(Outside US add $10) 


Total amount enclosed $ 




















Phone ( ___ ) 


Mail coupon to: Turbo C 1.5 Upgrade Dept., Borland International 
4585 Scotts Valley Drive, Scotts Valley, CA 95066 
This offer is limited to one upgrade per valid product serial number. Not good with any other offer from 


Borland. Outside US make payments by bank draft payable in US dollars drawn on a US bank. 
CODs and purchase orders will not be accepted by Borland. 
DDJ 3/88 
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WATCOM unleashes a high- 
performance optimizing C compiler 
and development system that delivers 
superior results for every professional 
programmer and offers the fastest 
programming environment you can 
get your hands on. 


Producing the fastest, tightest code 
available today, WATCOM C6.0 
offers major advantages in large 
memory models and floating-point 
computation. 


The WATCOM C6.0 system includes 
WATCOM Express C (also sold sepa- 
rately), a seamless development envi- 
ronment complete with unexcelled 
diagnostic capabilities to maximize 
your productivity. 
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Benchmark tests pitting WATCOM C6.0 
against Microsoft C5.0 and Turbo C 
demonstrate the optimum code size 
and speed your programs will achieve 
with WATCOM C6.0. Sophisticated 
register allocation, true register varia- 
bles and flow analysis allow your code 
to run its fastest. Moreover, extensive 
fine-tuning is possible with numerous 
user options like in-line substitution of 
machine code for performance-critical 
areas. 
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We deliver more than performance. 
Flexible run-time conventions allow 
efficient interfacing to a wide range of 
libraries and language processors. 
WATCOM C6.0 supports small, 
medium, compact, large and huge 
memory models and the NEAR, FAR 
and HUGE keywords. 
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The fastest, tightest code 
(medium memory model*) 


The fastest, tightest code 
(small memory model*) 


25 
Iterations 
Sieve 


Dhrystone 





WATCOMC6.0 = Microsoft C5.0 
*IBM PC XT 


WATCOM C6.0 = Microsoft C5.0 Turbo C 


*IBM PS/2 Model 60 
seconds 


Floating point computation 
108.5 


Turbo C 


Turnaround Time (compile + link/load) 
14.12 


WATCOM Microsoft Turbo C 


Express C Quick C 
Time in seconds to compile 573 source lines plus includes, 
and link 7 additional OBJ files created from 1391 source B WATCOM es Microsoft Turbo C 
lines. IBM PS/2 Model 60, small memory model. Program C6.0 C5.0 
used: GREP. Time in seconds to run 25 iterations of Whetstone. 
Small memory model (64K code, 64K data) 


IBM PS/2 Model 60 
with emulation 


IBM PC XT 
with 8087 
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Express C’s fastest available compile 
turn-around assists you with syntax 
and prototyping. With integrated 
tools like an editor and a symbolic 
debugger, you'll be amazed at how 
quickly you see your results. 
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Express C, included with WATCOM 
C6.0, has unique error checking that 
quickly uncovers many common and 
difficult bugs in “correct” code that 
other compilers miss. Take advantage 
of the powerful integrated debugging 
in Express C, then use WATCOM 
C6.0 for even tighter code and faster 
execution speed. Comprehensive 
compile-time and run-time messages 
enable effective programming prac- 
tices which you can extend with our 
fast development tools: MAKE, a 
disassembler, an object librarian 
and an overlay linker. 


& 
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Technical Suppor‘ 


Because we know how valuable your 
time is, our on-line help is always 
available. Our software maintenance 
and licensing plans will keep you up to 
date. With them, our expert technical 
support is just a phone call away. 
When you create a great new prod- 
uct, our run-time library code can be 
licensed without royalties or account- 
ing. Naturally, training seminars are 
available at our Customer Education 
Center or your site. 
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B 
Superior Value 


The WATCOM C6.0 system delivers 
superior value, returning your invest- 
ment promptly by saving your valu- 
able time. Our twenty years of 
computer language experience began 
in 1965 when our WATFOR authors 
wrote the book on high-productivity 
debugging compilers. The WATCOM 
C compiler is based on the sixth in a 
series of 8086-family code generators 
used since 1981. Today, we remain 
committed to delivering world class 
programming tools. 


WATCOM C and WATCOM Express C are trademarks of WATCOM 


Superlative Performance 


e Full ANSI C Optimizing Compiler 
© Source Editor 

e Full-screen Source-level Debugger 
e Full ANSI C Run-time Library 

© Overlay Linker : 








With WATCOM C6.0, you can debug large applications 


without extended memory. 








Unparalleled Productivity 


e Full ANSI C Compiler 

e Integrated Source Editor 

e Integrated Debugger 

e Full ANSI C Run-time Library 
e Integrated Linker/Loader 


© Object Librarian List © Overlay Linker List 
ice: rice: 
e MAKE ere e Object Librarian oe 
¢ Disassembler ° MAKE 
8 Express Cc Introductory Introductory 
Price: Price: 


$295" 975° 


Available for IBM PCs, PS/2s and true compatibles with DOS. General availability March 1, 1988. 


*L imited time introductory prices apply only to prepaid orders (VISA/MasterCard). 
Shipping and handling extra. 
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_____ | want to order WATCOM C6.0, ee : 
Please send me organization site 











regularly priced at $495 and well worth it, i aid ‘ 

for just $295. icensing information. . 
______ | want to order WATCOM Please convince me further by 
Express C, regularly priced at $125 for sending a complete product description of 

just $75. WATCOM C6.0. 
Name Title 
Company 
Sr 
City State Zip 

information needed for Credit Card orders: 

Signature Tel. 








Credit Card: Visa MasterCard 


Card # 


WATCOM 


Dept. DDO03B 
1430 Massachusetts Avenue 


Cambridge, MA 02138 


Expiration Date 
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Products Inc. ©Copyright 1988 WATCOM Products Inc. 


¥ 
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Turbo C vs. Quick C 

Dear DDJ, 

I read with great interest Allen 
Holub’s article on C compilers in 
the October 1987 issue, in particular 
the comparison between Turbo C 
and Quick C. I largely agreed with 
his point of view about the program- 
ming environments, which I have 
little use for—they get in the way 
and are an additional source of com- 
piler bugs. On other points, how- 
ever, I disagree. 

I finally received my Microsoft C 
5.0 upgrade from 4.0 yesterday (De- 
cember 4). Allen’s complaints about 
the delays in delivery of Turbo C 
seem ironic to me, given the even 
longer delays in shipping Microsoft 
C and Quick C. 

Allen’s tests of the compilers must 
have been incomplete because he 
rates Quick C as clearly superior to 
Turbo C. There are several respects 
in which Turbo C 1.0 is superior to 
Quick C 1.0, and Turbo C increases 
its lead with Version 1.5. 

First, Turbo C’s documentation is 
much better. Second, Turbo C com- 
piles 35 percent faster when you use 
Quick C’s optimization switch. 
Third, even with Quick C’s optimiza- 
tion turned on, executables pro- 
duced by Turbo C run 15 percent 
faster than those generated by Quick 
C using my generic math function 
and numerical benchmark (PC Tech 
Journal, January 1988). 

Fourth, and by far the worst, there 
is a serious bug in Quick C’s numeri- 
cal library: sines and tangents are 
apparently computed only to float 
_ accuracy, even when all real func- 
tions and variables are declared 
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double. Alone of seven PC C compil- 
ers I have tested, Quick C fails my 
double-precision accuracy diagnos- 
tic on these functions. Quick C’s 
debugging facilities are superior to 
the nonexistent ones for Turbo C 
1.0, but Borland says it will rectify 
this situation “soon.” 

The only reason I can see for 
using Quick C is to migrate easily to 
Microsoft C 5.0. Even so, nonop- 
timized compilation for Quick C 
takes almost 50 percent of that for 
Microsoft C 5.0. This doesn’t seem 
worth it to me because Quick C 
doesn't produce the same numbers 
as Microsoft C 5.0. 

Users of these compilers should 
be warned that optimization with 
Quick C does not change the nu- 
merical results (though it does mark- 
edly slow compilation), but iterative 
multiplications and divisions pro- 
duce slightly different results with 
Microsoft C 5.0 when you optimize 
the loops. 

Jim Roberts 

3605 Centinela Ave., #2 

Los Angeles, CA 90066 


Allen replies: 
I disagree. 

First, release dates. There are two 
points: 
1. Borland wouldn't give me a prere- 
lease version of Turbo C. It gave a 
dog and pony show down in Scotts 
Valley but wouldn't give me a copy 
of the compiler to work with at 
home. I’m not willing to review a 
product that I can’t work with on a 
day-to-day basis, and because I had 
a beta version of Quick C, I felt 
competent to talk about it, even 
though it hadn’t been released at 
that time. 
2. I agree, that neither company 
should have advertised their prod- 
ucts as finished until they were. The 
problem here is projected release 
dates vs. advertising deadlines. You 
have to place an ad several months 
in advance of its publication, and it 
is usually impossible to guess accu- 
rately when a real product will be 
finished. I think that both Microsoft 
and Borland jumped the gun, how- 
ever. 

Second, by my standards Turbo 


C’s documentation is inferior to 
Quick C’s. The two users’ guides are 
comparable, but Turbo C’s library 
documentation is miserable. It’s 
poorly organized and formatted; the 
programming examples—if they’re 
there at all—are trivial; and obscure 
and nonstandard subroutines are 
often documented (and I use the 
word loosely) in only two or three 
sentences. I use the run-time library 
documentation for my compiler on 
a daily basis; I read the users’ guide 
once when I get the compiler. Con- 
sequently, the quality of the former 
is much more important, and Turbo 
C falls down in that department. 

Next, I’m not sure about the com- 
parative compile times with the 
newest Turbo C version. I haven't 
seen a copy. As I said in the review, 
I was using Turbo C 1.0 and a beta 
version of Quick C, so it’s likely that 
things have changed. Mr. Roberts 
and I are testing the compilers in 
radically different ways, however. My 
benchmarks were two very large pro- 
grams (versions of the Unix lex and 
yacc utilities) that used virtually no 
numeric computa-tions but did a 
lot of data manipulation, especially 
at the bit level. Mr. Roberts seems to 
be compiling smaller, numeric-inten- 
sive programs. 

Because I disliked both of the in- 
teractive environments, I compiled 
with the command-line versions of 
both compilers, the compile process 
driven from a make file. I did find 
that it took longer to load Quick C 
than it did to load Turbo C. In fact, 
on a short program, it often took 
more time to load Quick C than to 
run it. Because I was compiling rela- 
tively large modules, however, the 
load time was insignificant when 
measured against total compile time. 

Compile time is relatively insignifi- 
cant in the greater scheme of things, 
however. If I save five hours with a 
good debugger but waste an hour 
with longer compile times, I’m still 
four hours ahead. Quick C's debug- 
ging facilities are indeed superior to 
the nonexistent ones for Turbo C, 
and the debugger alone makes 
Quick C a considerably more useful 
compiler, especially if you're just 
learning the language. Borland 
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Stunning speed. Unmatched performance. Total flexibility. Simple 
and intuitive operation. The newest VEDIT PLUS easily satisfies 
the most demanding computer professional. 


The free demo disk is fully functional—you can try all features 
yourself. Best, the demo includes a dazzling menu-driven tutorial 
— you experiment in one window while another gives instructions. 


The powerful “macro” programming language helps you eliminate 
repetitive editing tasks. The impressive demo/tutorial is written 
entirely as a “macro~—it shows that no other editor's “macro” lan- 
guage even comes close. And VEDIT PLUS is only 40K in size. 


Go ahead. Call for your free demo today, You'll see why VEDIT 
PLUS has been the #1 choice of programmers, writers and engi- 
neers since 1980. 


The installation lets you pick from closely emulating the keyboard 
layout of Word Perfect, WordStar and others. Or you can easily 
Create your own layout and even your own editing functions. Sup- 
ports any screen size—you pick screen colors and attributes. 


Supports the IBM PC, XT, AT and PS/2. Also supports MultiLink, 
PC-MOS/386, Concurrent DOS and most networks. Also avail- 
able for MS-DOS, FlexOS (protected mode), CP/M-86 and CP/M. 
(Yes, we support windows on most CRT terminals, including CRTs 
connected to an IBM PC.) Order direct or from your dealer. $185. 


Special: VEDIT (single file, no windows) for CP/M—$49. 


@ leleVileo 


VEDIT and CompuView are registered trademarks of CompuView Products, Inc. BRIEF is a trademark 
of UnderWare, Inc. PMATE is a trademark of Phoenix Technologies Ltd. Norton Editor is a trademark 
of Peter Norton Computing Inc. MultiLink and PC-MOS/386 are trademarks of the The Software Link, 
Inc. CP/M and FlexOS are trademarks of Digital Research. MS-DOS is a trademark of Microsoft. 


*Also available for Tl Professional, Tandy 2000, DEC Rainbow, Wyse WY700 and others. 
*Demo disk is fully functional, but does not readily write large files. 
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Call 1-800-45-VEDIT for 
FREE Fully Functional Demo Disk 































e Fully Network Compatible 
e Call for XENIX-286 version 
e 30 Day Money-back guarantee 


Norton 


BRIEF Editor PMATE 

‘Off the cuff macros No No Yes 
Built-in macros Yes No Yes 
Keystroke macros Only 1 No No 
Multiple file editing 20 + 2 No 
Windows 20 + 2 No 
Macro execution window No No No 
Pop-up menus No No No 
Execute DOS commands Yes Yes Yes 
Automatic processing of 

Compiler errors Yes No No 
“Cut and paste” buffers 1 1 1 
Undo line changes Yes No No 
Paragraph justification No No No 
Convert to/from WordStar No No No 
On-line calculator No No No 
Configurable Keyboard Hard No Hard 
43 line EGA support Yes No No 
Manual size/index 250/No 42/no 469/Yes 






Benchmarks in 120K File: 


2000 replacements 1:15 min 34sec — 1:07 min 
Pattern matching search 20sec Cannot Cannot 
Pattern matching replace 2:40 min Cannot Cannot 








CompuView 


1955 Pauline Blvd., Ann Arbor, MI 48103 
(313) 996-1299, TELEX 701821 
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seems to be fostering rumors that 
it's working on a debugger, but the 
last time I talked to the people at 
the company, they wouldn't: even 
commit to the fact that a debugger 
was in progress, much less give me 
a projected release date. It may be 
available “soon,” but are they talking 
geologic time or historical time? 

Other problems are reliability and 
portability. My Turbo C-compiled 
benchmark didn't run initially be- 
cause of bugs in and omissions from 
the I/O library. There was no signal() 
function, getenv() didn't work prop- 
erly (it returned a PATH environ- 
ment when I had asked for a PA 
environment but had set PATH first), 
and so forth. 

Of course, by the time you read 
this letter, things may have changed: 
Borland may have fixed the docu- 
mentation, improved the library, and 
come out with a debugger to match 
dbx on a Sun workstation. But I’m 
only willing to discuss products that 
I actually have in my hands. Simi- 
larly, I test compilers by working 
with them rather than by running 


artificial benchmarks. Consequently, 
I'm likely to miss a few things that I 
don't use very much (like the accu- 
racy of a sine function), but I think 
my methods give a much better feel 
for how a product works in general 
than do more formal benchmarks. 


Dear DDJ, 

We'd like to set the record straight 
on the shipment of Borland Interna- 
tional’s Turbo C. 

- Borland announced shipment of 
Turbo C and distributed the prod- 
uct on the same day: May 14, 1987. 
We said we'd ship in the second 
quarter of 1987, and we made it by 
over a month and a half. 

We'd also like to point out that 
Borland collected no money before 
the product began shipping. As a 
matter of policy, Borland neither 
cashes checks nor bills credit cards 
until a product is shipped. 

With the volume and depth of 
information that Dr. Dobbs’ offers, 
its hard to check every detail. 
Thanks for letting us contribute to 
your fine publication. 


NINE KINDS OF PROGRAMMERS: 
We're not just nerds, anymore! 


hobbyist 


researcher 
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hacker 


: pirate : 


unemployed 


Borland International 


The editor replies: 

It was never our intention to imply 
that the folks at Borland were com- 
mitting mail fraud, or anything of 
the sort. Borland has generally per- 
formed very well in customer rela- 
tions. 

It was incongruous, however, to 
have Turbo C arrive at our offices 
with a note from Philippe Kahn pro- 
claiming the product was shipping 
“right on time’—three months after 
the first ads had appeared in maga- 
zines. To claim that an advertise- 
ment with a snip-out coupon and 
an 800 number for credit card 
orders isn’t an official product an- 
nouncement is mere sophistry; ads 
are designed with coupons and 
credit card phone numbers to gener- 
ate an immediate response. Our read- 
ers had every reason to expect ship- 
ment within 30 days of the first ad. 

In short, if Borland had originally 
planned to ship Turbo C in the 
second quarter it would have been 
more honest to either postpone the 
ad a few months or include a dis- 
claimer (‘please allow 3 to 4 months 
for shipment”’). 


Corrections 
Dear DDJ, 
Readers, your response to “An Ex- 
tended IBM PC COM Port Driver” in 
the June 1987 issue of DDJ was grati- 
fying. The version of excom.asm avail- 
able from DDJ on diskette seems to 
be working, whereas exmode.c has 
a serious bug. Exmode will work 
correctly if you have two COM ports 
and will not do anything right if you 
only have one port. Specifically, in 
one-port systems exmode_ will 
always respond with “excom not in- 
stalled” and fail to execute your com- 
mands. To correct this, change the 
&& in the first if statement of main 
to «. In addition, some early versions 
of exmode used remove as a func- 
tion name. This conflicts with some 
libraries and can be corrected by 
renaming the function. How embar- 
rassing, sorry ‘bout that. 

Tom Zimniewicz 

Lima, NY 14485 


DDJ 
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The POLYTRON Version Control System (PVCS) 
simplifies and automates Configuration Manage- 
ment so programmers and managers can effectively 
control the revisions and versions of source code. 
PVCS is the most widely used change control 
product and is used by the leading software, 
aerospace, manufacturing and service companies. 


“In terms of features, PVCS pro- 
vides everything necessary to a 
large multi-programmer project — 
more than any other package 
reviewed. No restrictions are placed 
in the development environment 
and all aspects of operation can be 
customized for specific project 
needs. ”” 


PC Tech Journal 
September 1987 


Unmatched Flexibility 


© Storage & Retrieval of Multiple Revisions of Source Code 
¢ Maintenance of a Complete History of Changes 

¢ Control of Separate Lines of Development (Branching) 
¢ Resolution of Access Conflicts 

¢ Optional Merging of Simultaneous Changes 

¢ Release and Configuration Control 

¢ Project Activity Reports 

¢ Management Reports 

¢ Command or Menu Interface 


Project Control 


PVCS maintains individual archieves of all project 
components in your system — source code 
modules, data files, documentation and even ob- 
ject code libraries. These “source documents” can 
be written in any language or multiple languages. 


Fast Retrieval of Revisions 


PVCS uses “reverse delta storage” which saves disk 
space and speeds retrieval of versions of any file in 
the project database. A delta is the set of differences 
between any revision and the previous revision. 
PVCS can rapidly recreate complete versions of any 
file whether it is the most recent revision of a 
module or the original version of the entire project. 
Differences are automatically detected and stored. 


A Practical 













Necessity for LANs 


While important for single-programmer projects, 
PVCS is absolutely essential for multiple-program- 
mer projects and LAN-based development efforts. 
In a LAN environment, source code files are simply 
too easy to change. Because any change to any file 
can have major ramifications, coordinating and 
keeping a record of changes is critical. Project 
leaders can determine, on a module-by-module 
basis, which programmers can access or modify 


Once you standardize on PVCS, the archives 
used to track and monitor changes are inter- 
changeable between any PVCS product. 


Personal PVCS — Offers most of the power and 
flexibility of Corporate PVCS, but excludes the 
features necessary for multiple-programmer 
projects. 


Corporate PVCS — Offers additional features to 
maintain source code of very large and complex 
projects that may involve multiple programmers. 
Includes multi-level branching to effectively main- 
tain code when programs evolve on multiple 
paths. 


Network PVCS — Extends Corporate PVCS for 
use on Networks. File locking and security levels 
can be tailored for each project. 


PVCS for VAX systems — Requires VMS. Uses 
the same interface and archive format as MS- 
DOS version. Supports branching and offers file 
locking and other security features for multiple- 
programmer projects. 





source files, libraries, object code and other files. 
The levels of security can be tailored to meet the 
needs of nearly every project. PVCS works on all 
major LANs including 3Com, Novell and the IBM 
Token Ring Network. 


“PVCS has helped us maintain nearly 
90 programs and utilities. Without it 
we would not have the quality of our 
upcoming release of NetWare. ’’ 


Jonathan Richey 
Manager, NetWare Utilities 
Novell 


Adopt PVCS on Your Existing Projects 


You can obtain the benefits for your current pro- 
ject without disrupting development, regardless of 
how long your project has been under way. You can 
build PVCS archives from revisions stored in your 
present files or simply adopt PVCS from the cur- 
rent date. 


PolyMake Reads PVCS Logfile Format 


PolyMake, the leading Make utility, understands 
the structure of PVCS logfiles and is able to correctly 
determine the date and time of any revision. This 
prevents unnecessary operations that occur when 
the date and time of the complete project archive 
itself is used as with other make utilities. 


—aalee | | | 


$149 


Network PVCS $995** $4,950 $9,500 |$10,500+ 
Network $447** $2,375 | $2,500+ 
PolyMake 


**5 Station LAN License. Call for pricing 
on larger Networks. 


TO ORDER: 
1-800-547-4000 
Dept. DDJ 


Oregon & Outside USA call (503) 645-1150. 
Send Checks, PO.s to: POLYTRON 
Corporation, 1700 NW 167th Place, 

Beaverton, OR 97006 





POLYTRONE 


High Quality Sottware Since 1982 
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There is only one 
true test for a high performance 
C compiler....your program 


segs Imp->mod_ _segide [target_ datum) ]. os £: 





The most important 
measurement for rating 
your C compiler's 
execution speed is the 
performance of your 
program. C86PLUS' multi- 
pass optimizer concentrates on 
value use anaylsis and register 
selection, as opposed to areas that 
have little or no impact on 
program size or speed except in 
benchmarks. 

With this approach in mind, 
Computer Innovations’ 
C86PLUS v.1.10 is geared for 
large, real world applications 
rather than promotional 
benchmarks, which in many 
cases, do not accurately reflect 
superior code generation. 

And while most compiler 
vendors rely on their benchmark 
claims and lengthy optimization 
listings to sell speed, we're 
relying on what really counts the 
most -- the performance of your 
program. 


C86PLUS has the 
features you need for 
professional-level 
application development. 
The latest proposed ANSI C 
libraries; 80386-specific compiler 
options to take advantage of the 
32-bit architecture while running 
under DOS in real mode; 100% 


ROMable code for embedded 
systems development; a MAKE 
utility; C library source code at no 
extra charge; and FORTRAN, 
Pascal calls. 

Small, medium, compact and 
large memory model support; 
powerful math libraries and inline 
floating point support for 
computation-intensive 
programming; Microsoft C v.4.0 
and UNIX System V 
compatibility for application 
portability; powerful support 
tools for increased programmer 
productivity; and the ability to 
write interrupt routines in C 
rather than assembler. 


Support to keep you 
satisfied. Whatever the time or 
problem, we're prepared to help. 
Computer Innovations (CI) offers 
telephone technical support 
during regular business hours, a 
dial-up 24-hr. bulletin board 
service or you can contact us via 
our vendor conference on BIX. 

Should add-on productivity 
products be of concern, 
C86PLUS is supported by most 
major third-party vendors and CI 
resells them for your added 
convenience. CI also offers 
products specific to embedded 
systems application development 
and C language training. 





Experience performance 
from a real point-of-view. 
Order now or contact us-for 
more information. 


800-922-0169 


COMPUTER 
INNOVATIONS 


980 SHREWSBURY AVE. 
TINTON FALLS, NJ 07724, USA 
TLX: 705127 COMP INNOV UD 

(201) 542-5920 


COG. 


C COMPILER 


(call for current pricing and version) 


Minimum System Configuration: Intel 8086/186/286/386-based system running DOS 2.1 or 
above; 384K RAM and a hard disk drive is required.Registered trademarks: Microsoft (Microsoft 
Corp.), UNIX (AT&T-Bell Labs), Intel (Intel Corp.), BIX (McGraw-Hill, Inc.). 
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ARTICLES 


Object-Oriented 
Programming 
and Databases 


by Jacob Stein 


early 1970s, E.W. Dijkstra introduced us to struc- 

tured programming and Nicklaus Wirth introduced 
us to stepwise refinement. These programming method- 
ologies were intended to foster a systematic and scien- 
tific approach to software development. That they were 
an improvement over previous methodologies, or the 
lack thereof, is not in doubt. What is in doubt is whether 
they are still germane to many applications being devel- 
oped today. Structured programming appears to fall 
apart when applications exceed 100,000 or so lines of 
code. Programmer productivity fails to meet expecta- 
tions and software maintenance becomes a nightmare. 
What we are left with is programmer fear: fear of side 
effects when fixing even minor bugs; fear of improving 
what already works, even if it does so poorly. 

It may be that the complexity of the application itself 
is responsible for this failure. On the other hand, our 
understanding of the application domain may be the 
limiting factor. Although the underlying models for 
banking and other conventional applications have been 
understood for millenia, the underlying models for new 
application areas such as computer-aided software engi- 
neering (CASE) and computer-integrated manufacturing 
(CIM) are as much a product of the process of applica- 


| E structured programming still relevant? In the 





Dr. Jacob Stein has been a senior software engineer at 
Servio Logic Corp. of Beaverton, OR since 1984. He is also 
an adjunct assistant professor at the Oregon Graduate 
Center. 
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tion development as they are inputs to the process. 
Structured programming assumes that the application 
developer stands a reasonable chance of getting it right 
the first time, and that once the application has been 
successfully coded, the application domain will not 
change. For many applications being addressed today, 
neither of these is likely. 

Object-oriented programming provides a paradigm 
suitable for these new application areas. Instead of 
looking at programs as algorithms and data structures, 
it looks at applications as the behavior of objects and the 
communication between objects. This communication 
takes place in the form of messages to which objects 
respond with suitable behavior. In addition, object- 
oriented programming addresses the vital need to vali- 
date abstractions before committing many man-years to 
a detailed implementation and the fact that application 
domains change with time. Diedrich and Milton refer to 
the style of development encouraged by object-oriented 
languages as “fearless programming.” 

By organizing objects into classes, which encapsulate 
object behavior in a manner similar to abstract « 
types, and organizing classes into an inheritance 
chy, object-oriented programming may finally p 
the long sought after sharing and reusability 
The code that gives a data structure its meaning, 
semantics, is no longer spread amongst disparate appli- 
cation programs. Perhaps one of the most frustrating 
aspects of trying to reuse code in a new application is 
that the old code almost, but not quite, fits the needs of 
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Some applications demand improved 


algorithms, and some requ 


ITe 





proved languages 
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new class can be created from an existing class by 
specifying only the differences between the existing and 
new class; all else is inherited by the new class from the 
existing class. PPI’s belief in the encapsulation provided 
by object-oriented systems and lead them to trademark 
the term Software-IC. 

Object-oriented languages tend to be memory-based 
and are geared toward supporting a single user or 
application. Objects either do not persist between pro- 
gram executions or are saved in a primitive manner that 
does not lend itself to sharing (for example, copying a 
program’s image to disk). It would be difficult for a 
design layout tool and a design rule checker to share 
data, let alone run concurrently. Object-oriented data 
management systems rectify this situation by providing 
data management facilities. The trick here is to provide 
these facilities in a manner that provides flexibility and 
merges well with the object-oriented paradigm. 


An Object-Oriented Model 
This section outlines the OPAL programming language 
and GemStone data model developed by Servio Logic 
Corp. Most of the constructs described here are present, 
in one form or another, in all object-oriented languages. 
The concepts of objects, messages, methods, classes, 
and class hierarchy are essential to all object-oriented 
models. You should beware of systems that claim to be 
object-oriented yet do not contain similar concepts. 
The three principal concepts of the model and lan- 
guage are object, message, and class. They correspond 
roughly to record, procedure call, and record type in 
conventional systems. (Table 1, page 22, gives some 
other correspondences.) An object is a chunk of private 
memory with a public interface. Objects communicate 
with other objects by passing messages, which are 
requests for the receiving object to change its state 
and/or return a result. The set of messages an object 
responds to is called its protocol (its “public interface”). 
An object may be inspected or changed only through its 
protocol. The means by which an object responds to a 
message is a method. A method is an OPAL procedure 
that is invoked when an object receives a particular 
message. So that each object need not carry around its 
own methods, objects with the same internal structure 
and methods are grouped into a class and are called 
instances of the class. The methods and structure are in 
a single object describing the class—the class-defining 
object (CDO)—and all instances of the class contain a 
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reference to the class-defining object. Unlike some other 
object models, an object is an instance of exactly one 
class. 

Every object has a unique identity. In OPAL, an object 
is identified by its object-oriented pointer (OOP). An 
object's identity is invariant: it remains the same regard- 
less of changes in the object’s state. OPAL does not 


|| Support the become: message, which interchanges the 
| identity of two objects. Smalltalk uses this message for 
| screen manipulation and growing objects. GemStone’s 


esigners considered become: an inappropriate solution 
to the problems it addresses. The functionality it is used 


: — | for is implemented in other ways. 
_ | the new application. In an object-oriented language, a 


Objects 

Internally, most objects are divided into fields, called 
instance variables. Each instance variable can hold a 
value, which is usually a reference to another object. 
Figure 1, page 22, shows an Employee object with four 
instance variables: empName, ssNo, address, and salary. 
The empName instance variable holds an object that is 
an instance of the PersonName class. Not all objects are 
internally divided into instance variables. Certain basic 
types such as SmallInteger and Character are not fur- 
ther decomposed. These basic types are self-identifying 
as they have a direct representation. 

The instance variables in the Employee object are 
called named instance variables. An object can have 
indexed instance variables, which can be viewed as 
instance variables with numbers instead of names. In- 
dexed instance variables are used mainly for implement- 
ing ordered collections, such as arrays. 


Messages 

The basic form of all message expressions is <receiver> 
<message>. The <receiver> part is an identifier or 
expression denoting an object that receives and inter- 
prets the message. The <message> part gives the selec- 
tor of the message and possibly arguments to the 
message. Every message returns a result to the sender, 
which is usually another object. There are three kinds 
of messages: unary, binary, and keyword. 

Unary messages have no arguments and have selec- 
tors that are a single identifier. Assume that emp is a 
variable holding an Employee object. If there is a unary 
message firstName to retrieve the first name of the 
employee, then emp firstName returns a string that is 
the first name of emp. 

Binary message expressions have a receiver, one argu- 
ment, and a message selector that is one or two nonal- 
phanumeric characters. To multiply 8 by 3, for example, 
you send to 8 the message “Multiply yourself by 3”: 8 * 3. 
Here, * is the binary selector for the multiplication 
message. Comparisons are also handled with binary 
messages. In the following expression: 


(emp1 salary) <= (emp2 salary) 
the receiver and argument of the <= binary message 
are both results of unary message expressions. 


Keyword messages have one or more arguments and 
have multipart selectors composed of alphanumeric 
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Introducing Quarterdeck Expanded Memory 
Managers™: QEMM 386 and QEMM 50/60. 


Your 80386 PC, IBM® Personal System/2™ Model 80, PC or 
AT with 80386 add-in board, as well as your IBM Personal 
System/2 Models 50 or 60 can all break through the DOS 
640K barrier. Now you can have maximum use of your 
memory—whether you have one megabyte or 32— with the 
Quarterdeck Expanded Memory Manager. All without 
having to purchase special expanded memory boards. 


Unlock hidden potential beyond 640K. 


QEMM uses hidden features within your existing 
memory to make it compatible with the Lotus-Intel-Micro- 
soft Expanded Memory Specification (EMS) version 4.0. 

Now you can run colossal spreadsheets, databases, and 
CAD models designed for expanded memory. Using Lotus 
1-2-3, Symphony, Framework, Paradox, AutoCAD, 
Microsoft Excel and more. 


Improve productivity with DOS multitasking. 


And if you'd like to use these programs all together 














For 386 PC, IBM PS/2 model 80 and 80386 add-in board users, QEMM/386: 


¢ Fully supports the Lotus-Intel Microsoft Expanded Memory Specification (EMS) version 4.0 

eEnables the 80386 user to configure the 80386’s memory beyond the first megabyte as expanded memory or as a 
combination of both expanded and extended memory. 

Fills out missing DOS memory to 640K and beyond by mapping into unused video memory. When used with a CGA 
graphics adapter this can give you 736K instead of the standard 640K for DOS. 

¢ Automatically detects the speed of the memory in your PC and uses fast memory whenever possible. 

e Increases system performance by remapping slow ROM into the 386’s fast RAM memory. 

¢Frees up DOS conventional memory by loading memory-resident programs above video buffers. 

¢ Supports 386 protected-mode programs, such as Ansa’s Paradox 386, that use Phar Lap Software's 386 DOS 
Extender. 

Turns DESQview into a 80386 control program, using the 80386's 8086 machine architecture to run multiple large 
programs concurrently. 

¢Takes approximately 1.5K of overhead from the PC’s conventional memory used to run DOS programs. 











System Requirements: 80386 PC, IBM PS/2 Model 80, or standard 8088, 8086, 80286 with 80386 add-in board. 





For IBM PS/2 model 50 and 60 users, QEMM-50/60: 


¢Fully supports the Lotus-IntelMicrosoft Expanded Memory Specification (EMS) version 4.0. 

eTakes advantage of the hardware capabilities of the IBM PS/2 80286 Memory Expansion Option to transform its 
“extended” memory into “expanded” memory. 

On PS/2 Model 50 and 60’s with 1.5 MB or more of the IBM Memory Expansion Option memory, enables 
DESQview to run multiple large programs concurrently. 


System : IBM PS/2 model 50 or 60 with IBM PS/2 80286 Memory Expansion Option board or 
compatible. Note: IBM PS/2 architecture requires disabling motherboard memory and ‘backfilling’ conventional 
memory to 1 MB in order for any multitasking environment to work, including Microsoft Windows 2.0, IBM’s 3270 
workstation program, or DESQview. QEMM will not run on 80286 computers with extended memory. 





©1987, Quarterdeck Office Systems. IBM®, Personal System/2™, OS/2™, Lotus®, Intel®, Microsoft®, Excel™, 
Windows™, 1-2-3®, Symphony™, Framework™, Ansa®, Paradox™, AutoCAD™, PC Magazine®, InfoWorld™, Phar 
Lap™ and AST™ are trademarks of their respective companies. 








—multitasking beyond 640K— QEMM extends the 
capabilities of our popular DESQview™ multitasking 
environment. 

DESQview lets your programs work 
together in a familiar way, giving you many of 
the capabilities and features only promised by 
other systems. In fact, the editors of PC Maga- 
EDITOR’S| Zine recently named it “Best Alternative to 
CHOICE | OS/2,” and InfoWorld gave it a report card 
NOV. 24, 1987 rating of 9.1. 


We offer productivity solutions for the forgotten 
12 million. 


If you are one of the 12 million or so 8088, 8086 or 80286 
PC users who feel left out of this new world, don’t despair. 
We have options that let you keep your computer and 
favorite programs and give you today what the newest 
— and operating systems are promising for the 

ture. 

Visit your dealer for more information on Quarterdeck 
products. And ask to see the chart we've prepared 
explaining today’s maze of memory options. and how you 
can break the 640K barrier. 
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Rush Me Quarterdeck Productivity Solutions Today! DDJ 3/88 
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Name on Credit Card: 


Shipping Address: 


ss QEMM and DESQview 
State: Zip: Tel: Quarterdeck Office Systems, 150 Pico Blvd. 
Santa Monica, CA 90405 (213) 392-9851 





Mail to address at right. 
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Note: If you own DESQview call us for a special upgrade offer, or send in your DESQview registration card. 
AST Special Edition owners included. 
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OBJECT-ORIENTED PROGRAMMING 
(continued from page 20) 


characters and colons. To set the third component of 
an array held in anArray to ‘Ross’, you use: 


anArray at: 3 put: ’Ross’ 
The same effect is accomplished in other languages by: 
anArray[3] := ’Ross’ 


The message selector here has two parts—at: and put:— 
because it takes two arguments: the array index and the 
object to be stored at that index. You refer to a message 
is referred to by the concatenation of its parts: at:put. 


Methods 
To construct a method you need to know what objects 
are visible within its scope. All the named instance 
variables of the receiver are available via their names. 
Thus, in a method for class Employee, as defined in 
Figure 1, the instance variables enpName, ssNo, address, 
and salary are accessible. 3 

A method may also have temporary variables, which 
are declared between vertical bars at the beginning of 
the method: .temp1 temp2.. Each user has one or more 
dictionaries of global variables, and those global vari- 
ables can appear in methods. You need two other 
operators before you can write methods: the assignment 
operator (:=) and the operator *, which returns the 
value of the expression as the result of a method. 

For a unary message wholeName in class PersonName 
that returns the first and last name concatenated with a 
space between, you can use the following method: 


__GemStone Conventional 


object 


instance variable 


instance variable 
contraint 


message 
method 


class-defining 
object 


class hierarchy 


class instance 


collection class 





record instance, 
set instance 


field, attribute 


field type, 
domain 


procedure call 
procedure body 


record type, 
relation scheme 


database scheme 


record instance 
tuple 


set, relation 


Table 1: Correspondences between concepts in Gem- 
Stone and conventional systems 
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wholeName 
ttempl 
temp := first. 
temp := temp + '’ + last. 
* temp 


The first statement, temp := first, assigns the value of 
the instance variable first in the receiver (a PersonName 
object) to the temporary variable temp. The statement: 


temp := temp + ’’ + last 


concatenates the value of temp, a blank, and the con- 
tents of the instance variable /ast of the receiver (+ is 
the binary message for concatenation of strings). The 
result of the concatenations is assigned to temp. Finally, 
the statement “temp returns the value of temp as the 
result of the message wholeName. (This particular mes- 
sage could be implemented with the single message 
expression * first + ’’ + last with no need for a 
temporary variable.) 

A method can also change the state of the receiver, by 


Employee 


PersonName 


Smallinteger 


Address 


StreetAddress | 


stNumber 
street 


city 


Smailinteger 





Figure 1: An Employee object and its four instance 
variables 
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ur software comes with something 


no one else can offer. 


When you join the Lattice family 
of customers, you'll discover that 
your software purchase is backed 
by more than just an excellent 
warranty. It’s backed by unparal- 
leled technical support. By a total 
commitment to your success and sat- 
isfaction. And by Lattice’s dedication 
to excellence in products and services. 


Unlike other software manufacturers 
who charge you for services after you've 
purchased their product, Lattice offers 
a unique package of support programs 
at a price we can all live with—FREE. 


Lattice Bulletin Board Service 
LBBS is our 24-hour a day bulletin 
board system that allows you to obtain 
notification of new releases, general 
information on Lattice products, and 
programs for the serious user. And if 
you've ever experienced the frustration 
of having to wait a year or more for 

a new release (that has corrected a 
bug), you'll really appreciate LBBS. 
Because with this service, you can 
actually download the latest program 
fixes to instantly eliminate any bugs 
discovered after release. 


Available through dealers and 
distributors worldwide. 


Lattice Service. 


Technical Support Hotline 
Responsible, dependable and capable 
Support Representatives are only a 
phone call away. You will talk to a highly 
skilled expert who is trained to answer 
any questions you have relating to 
specific Lattice products. Remember, 
your complete satisfaction is our goal. 


McGraw-Hill BIX™ Network 
The Byte Information Exchange (BIX) 
Network is a dial-in conference system 
that connects you with a Special Interest 
Group of Lattice users. The nominal 
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to BIX-mail your questions—via your 
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can post your questions in the con- 
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assigning new values to instance variables. Suppose 
objects of class Department have a budget instance 
variable. The following method increases a department's 
budget by a certain percentage, up to a limit: 


increaseBudgetBy: aPercentage upTo: aLimit 
budget := budget + (budget * (aPercentage / 100)). 
(budget > aLimit) iffrue: [budget := aLimit). 
* budget 


The increaseBudgetBy:upTo: message takes two argu- 
ments, represented by variables aPercentage and aLimit. 
This method changes the budget instance variable of the 
Department object that receives the increaseBudg- 
etBy:upTo: message. In the second line of the method, 
you see a keyword message ifTrue: that functions as a 
conditional control construct. The receiver of this mes- 
sage is a Boolean value. The argument of the message is 
a block. A block is a sequence of one or more OPAL 
statements within brackets and is a first-class object in 
GemStone. The effect of a message aBoolean ifTrue: 
aBlock is to perform the code in aBlock if aBoolean is 
true. The third line of the method returns the new value 
of budget. 

OPAL includes messages for iterative control struc- 
tures, using blocks with arguments. Block arguments are 
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ReadStream 
WriteStream 
System 
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Figure 2: Kernel classes in the superclass hierarchy 





declared at the beginning of a block. For example: 
[ni(2 * n) - 1) 


is a block with one argument, n. For this block to be 
evaluated, it needs a value for the argument. The value: 
message provides the argument and causes execution. 
A block returns the value of its last expression when 
executed. Thus: 


[n. (2 * n) —1] value: 7 


returns 13. In general, given a value of N, this block 
returns the Nth odd number. 

All methods you have seen so far have been defined 
in terms of other messages. The definitions of methods 
are not completely circular. At the bottom of everything 
are primitive methods. When the OPAL interpreter en- 
counters a message that has a primitive method, it 
executes a piece of machine code rather than an OPAL 
method. Primitive methods exist for arithmetic, compari- 
sons, object creation and copying, array selection, string 
manipulation, and set functions. The set of primitive 
methods in GemStone cannot be augmented by a Gem- 
Stone programmer, although such an extension could 
be provided. 


Classes 

Every class is represented by a class-defining object that 
describes the structure and behavior of instances of the 
class as well as the position of the class in the class 
hierarchy. Any. object will return the CDO for its class in 
response to the message class. Suppose the variable 
assoc holds an object of class Association. (Association is 


Classes Instances 
PersonName Ray Ross 
TitledName Dr. Ray Ross 
TitledNameWithLetters Dr. Ray Ross, OBE 


_— InstanceVariables Messages 


PersonName first first 
last first: 
last 
last: 
fullName 


TitledName (above) + (above) + 


title titledName 


TitledNameWithLetters (above) + 


letters 


(above) + 
titledName 
(new Method) 





Table 2: Representation of people’s names with titles 
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OBJECT-ORIENTED PROGRAMMING 
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a key-value pair used in building dictionaries.) The 
assignment: 


ac := assoc class 


causes ac to be assigned the CDO for class Association. 
CDOs respond to messages just as all other objects do. 
For example, CDOs respond to the name message. The 
result of the expression assoc class name is #Associa- 
tion. (Symbols are indicated with a # as a prefix.) 

The instance variable names and methods for in- 
stances of a class are stored in the CDO for the class. 
CDOs also store the methods that instances execute in 
response to various messages. When an object receives 
a message, it consults the CDO to find out how to 
execute that message. 

OPAL provides a class hierarchy to exploit similarities 
in structure and behavior of entities. (The built-in hierar- 
chy is shown in Figure 2, page 24.) A subclass inherits 
structure and behavior from its superclass. Structure is 
inherited in that all named instance variables in the 
superclass are also present in any subclass. Suppose 
you wanted objects that represented people's names 
with titles. You could create a subclass TitledName of 
PersonName, and instances of TitledName would auto- 
matically have instance variables first and last. You 
could add an instance variable, title, to TitledName to 
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hold the title. (See Table 2, page 24.) 

A subclass inherits methods from its superclass. Thus, 
if fullName is a message for PersonName, instances of 
TitledName respond to that message by using the 
method from PersonName. The lookup process to deter- 
mine which method corresponds to a message starts in 
an object’s class. If the message is not defined in that 
class, the search proceeds in the class’s superclass, the 
superclass of that class, and so forth. Thus, the im- 
plementation of fullName can be overridden in Ti- 
tledName if desired. 

A subclass can implement messages of its own. For 
TitledName you might want a message that returns a 
string containing the full name with title: 


titledName 
“title + ’’ + self fullName 


A new feature in this example is self; which is a special 
variable whose value is always the receiver of the mes- 
sage. 

A subclass can also reimplement an inherited mes- 
sage. Suppose you define a class TitledNameWithLetters 
as a subclass of TitledName. This subclass adds an 
instance variable letters that holds the letters after a 
person’s name, as in ‘Dr. Ray Ross, OBE’. You can 
reimplement the titledName message in TitledNameWith- 
Letters to include the letters after the name. 

In OPAL, unlike some object-oriented languages, in- 
stance variables may be constrained to a kind of a class. 
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An object is a kind of class foo if its class is foo or a 
subclass of foo. If instance variable personName in class 
Employee is constrained to PersonName, then in in- 
stances of Employee, personName could be an instance 
of PersonName, TitledName, or TitledNameWithLetters. 
Constraints may also be placed on the elements of 
collection classes such as Bag and Set. 


The Read-Write Boundary 

In the same manner as conventional programming meth- 
odologies are not appropriate for today’s applications, 
conventional data management systems are not appro- 
priate for managing their data. Conventional data mange- 
ment systems are best at two things. One, they are good 
at batch processing large amounts of homogeneous data 
such as monthly credit-card billings. Two, they are good 
for high-transaction-rate applications such as ATM net- 
works. The processing of data in applications such as 
CASE, cartography, and CIM fits neither of these two 
categories. The data in a cartographic database is not 
homogeneous, and transactions in a CASE system can 
take hours, or days, not just seconds. 

Perhaps the best argument for integrating a data 
management system with an object-oriented language 
can be made by looking at the impedance mismatch 
across the interface between conventional application 
and database languages. Conventional application and 
database languages are incompatible both computation- 
ally and structurally. 

Data manipulation languages use a read-write model 
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of interaction with application code. Database calls are 
embedded in the application language and allow for 
fetching, inserting, deleting, and modifying records or 
tuples. Although query languages have matured, allow- 
ing for the definition of complex views through sophisti- 
cated queries, they are by no means complete, and 
views are difficult to update. 

In any event, the communication between application 
and database is declarative, not procedural. The applica- 
tion tells the database what it wants, not how to get it. 
This works well when what the application wants can 
be specified declaritively and the database can figure out 
how to get it in an efficient manner. All too often, 
though, an application needs to intersperse several 
database calls amongst application code to perform 
what should be a single logical operation. 

A similar problem arises with regard to maintaining 
the consistency of a database. Many database systems 
do not allow constraints any more sophisticated than 
requiring key values to be unique. The application 
program ends up with the responsibility of maintaining 
all other constraints on the data. 

Consider an office management system in which 
several applications reserve meeting rooms. In such a 
system, each application would first check for the avail- 
ability of the room. This might involve fetching records 
to check that the individual reserving the room is 
authorized to do so and that the room has not already 
been reserved. The application would then post a record 
to indicate the reservation and perhaps post other 
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OBJECT-ORIENTED PROGRAMMING 
(continued from page 27) 


records to appointment calendars. A change to the 
structure of the database, or the policy for reserving 
rooms, might require locating and modifying every appli- 
cation that modifies the database. In an object-oriented 
data management system, a message could be defined 
that performed all necessary checks and updates to the 
database. In the event that the policy for reserving a 
room changes, the method for reserving a room could 
be easily located and modified. 

You might argue that in a conventional system the 
code for reserving a room could be factored into a single 
procedure—thus, achieving the same effect. In a conven- 
tional system, however, none of the applications is 
forced to use the procedure when making a reservation. 
The encapsulation provided by object-oriented data 
management allows the designer of a class to control 
access to data in instances of the class. By organizing 
the methods for a class along with the structural de- 
scription of its instances, the impact of changes in 
structure are localized. This control and organization 
becomes more important as the size and complexity of 
applications grow: placing the data in one file and the 
code that determines its meaning into several other files 
no longer makes sense. 

Two other negative aspects of the read-write model 
should be pointed out. One, a procedure may need to 
make numerous calls to the database. If a procedure 
needs to fetch 1,000 records, it may need to make 1,000 
calls. In an object-oriented. data management system, 
one message can take the place of many database 
operations. Two, conventional systems may be doing a 
lot of unnecessary copying. If a database is queried for 
employees who have been with a company for at least 
five years, the tuples corresponding to those employees 
are copied into the result. In an object-oriented system 
the result would contain only the identities of those 
employees. 

The differences between data types supported by the 
application language and the data management lan- 
guage cause structural impedance across the read-write 
boundary. Although programming languages directly 
support arrays, most relational systems must encode 
them by adding a field to represent offsets. This encod- 
ing requires a translation when arrays are retrieved 
from, or stored to, the database. Union types and nested 
structures are difficult to represent using relations. 
Application developers are typically faced with two 
choices. One, they can normalize the representation so 
that each relation stores only one of the unioned types 
and only flat structures are stored. Two, they can store 
uninterpreted bit strings if they fit within the size 
limitations imposed by the relational system. 

With the first choice, the application becomes de- 
pendent on the decomposition in order for the transla- 
tion to work properly when storing and fetching. Fur- 
thermore, in the relational model, the properties of an 
entity must be sufficient to distinguish it from all other 
entities. For an employee tuple to reference a depart- 
ment tuple, there must be some fields in department 


tuples that uniquely and immutably identify depart- 
ments. Using department names to identify department 
tuples is fine until a department's name changes. Main- 
taining the validity of foreign keys, such as a department 
name stored in an employees tuple, is known as referen- 
tial integrity. Making up unique department numbers 
might solve the problem; however, this adds an attribute 
that may not be present in the world being modeled and 
is a burden on application developers. With the second 
choice, the database isn’t providing any more functional- 
ity than a good file manangement system. 

Suffice it to say that conventional programming lan- 
guages manipulate data types by representing their 
structure in one place and distributing their semantics 
throughout the application code, whereas data manag- 
ment systems, because of their limited repertoire, can 
only manage data structures. An object-oriented data 
management system combines object-oriented program- 
ming with an integrated data model to free program- 
mers from the tedious and error-prone coding needed 
to accommodate a separate data management system 
that understands neither the execution model of the 
language nor the structures used by the language in 
representing its data types. 


An Object-Oriented Data Management System 
Arguing in favor of an object-oriented language that 
provides a common abstraction for data definition, data 
manipulation, and general computation is one thing; 
actually developing one is quite another. What follows is 
a discussion of object-oriented data management issues 
and how they are addressed by GemStone. 

One of the guiding principles in GemStone’s develop- 
ment was uniformity; all objects, be they temporaries or 
shared and disk-resident, should be accessed in a uni- 
form manner. This principle helped address the issue of 
how objects persist. Does an application explicitly state 
that an object is to be persistent and must be explicitly 
deleted, or do objects exist as long as they are reachable 
from a special root collection of objects? Some folks 
argue that persistence through reachability is not practi- 
cal for a disk-based system: garbage collection of disk- 
based objects incurs too much overhead. 

Let's take a look at the implications of explicit dele- 
tion. In the first place, who decides when an object can 
safely be deleted? In a shared environment, in which 
many applications are using the data, this is not an easy 
question to answer. When an object is deleted, what is 
to be done with all the references to that object? The 
problem is extremely similar to that of referential integ- 
rity in relational databases. 

_ Assume that it would be satisfactory to replace these 
references with references to a special object Nil. Either 
all the references are located and replaced in one 
operation, which corresponds to garbage collection, or 
all references are screened for deleted objects, which 
corresponds to incremental garbage collection. If refer- 
ences are screened, are all the instance variables of an 
object screened when the object is accessed, or are only 
those instance variables to which messages are sent 
screened? The former involves greater overhead, whereas 
the latter allows the propagation of references to a 
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deleted object: an object can be assigned to an instance 
variable without sending messages. 

Given that explicit deletion does not incur less com- 
putational overhead, is difficult to control in a shared 
environment, and is less transparent to applications, 
persistence through reachability was chosen for Gem- 
Stone. Instances of class UserProfile are used to repre- 
sent properties of each user, including a list of dictionar- 
ies to be used in resolving symbols when compiling 
OPAL code for that user. Any object that is reachable 
from a dictionary in any user’s UserProfile is persistent. 
Dictionaries are also used to manage name spaces and 
sharing. When an identifier is encountered and it does 
not correspond to a temporary, instance, or class vari- 
able, the dictionaries are searched to find an object 
corresponding to that identifier. A user may have any 
number of dictionaries to accommodate various degrees 
of sharing. 


Data Integrity 

Three kinds of failure can compromise the integrity of a 
database: an application may fail to complete because 
of a run-time error; the processor managing secondary 
storage may fail; and the media used to store objects 
may fail. Protection against media failure is achieved by 
replicating objects on disk. 

Failures of the first two kinds require the careful 
posting of an application’s changes to the database. By 
ensuring that either all, or none, of an applications's 
changes are posted, inconsistent states of the database 
are avoided. This all-or-nothing form of posting changes 
is known as atomicity. Applications generally use commit 
and abort commands to define the changes that are to 
be atomically posted. When an application commits, an 
attempt is made to post all changes made by the 
application since the last commit or abort (you pretend 
that the first thing an application does is an abort). If all 
changes are successfully posted, then the commit suc- 
ceeds; else the commit fails and the application is so 
informed. When an application aborts, all the changes 
made since the last abort or successful commit are 
thrown away. 

The activity that occurs between an abort or commit 
and the succeeding abort or commit is known as a 
transaction. When a failure of the first two kinds occurs, 
it is treated as though the transaction had aborted. 






Figure 3: Clustering of an Employee object 
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Figure 4: Clustering of Employee objects omitting their addresses 


When the processor fails, a lot of fancy footwork is 
required to guarantee that all the needed information is 
safely on disk, but it works. 

' The two basic choices for implementing atomicity are 
logging and shadowing. With logging changes are posted 
directly to the database and logged. When a transaction 
aborts, the log is used to restore the database to its 
previous state. A successful commit allows the log to be 
thrown away and a new log started. With shadowing, 
changes to an object are posted against a copy (a 
shadow) of the object. When a transaction aborts, the 
shadow copies of objects are thrown away. The database 
is left alone, as it has not been modified. For a transac- 
tion to successfully commit, all modified objects must 
be carefully replaced with their shadow copy. 


Concurrency Control 

Any system that allows concurrent access to shared data 
must handle conflicting changes made by applications 
running concurrently. Either conflicting changes are 
prevented (pessimistic concurrency control), or conflict- 
ing changes are discarded (optimistic concurrency con- 
trol). Pessimistic concurrency control requires that a 
transaction state its intention prior to accessing an 
object by acquiring either a read-lock or a write-lock. 
While a transaction holds a lock on an object, other 
transactions are prohibited from acquiring a lock that 
would allow conflict. Optimistic concurrency control 
allows a transaction to proceed as though it were 
running alone. At transaction commit, the changes made 
by the transaction are checked for conflict with other 
transactions. If a conflict is detected, the changes made 
by the transaction must be undone. 

As you may have noticed, concurrency control and 
data integrity are strongly related. Pessimistic concur- 
rency control is generally bundled with logging, optimis- 
tic concurrency control with shadowing. Conventional 
data management systems tend to use locking and 
logging. The advantage of optimism and shadowing is 
that transactions do not manage locks. The down side 
is that arbitrary amounts of work can be lost when 
conflict is detected at commit. The situation is reversed 
for locking and logging. One further disadvantage of 
locking is deadlock: two transactions are unable to 
complete until each gets a hold of a lock the other is 
holding. 

For the initial implementation, optimism and shadow- 
ing were chosen. This choice was guided by a desire for 
uniformity. As GemStone supports general programming 
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The Ultimate dBase Compiler 


FORCE III is the world’s fastest dBase Best of all, FORCE III creates very small .EXE files. The .EXE files 
compiler. It compiles and links the quickest, are true native code files and do not rely on any kind of memory resident 
and the -EXE files it creates run so fast library or interpreter! The reasons the .EXE files are so small are 

you ll swear you wrote your program in C. = simple: FORCE III is an 


To give you an idea how fast, take a look at 
the Index Speed graph below. This graph 
compares indexing speeds of the different 
products using a database which contained 
8,000 records. The database was indexed 
on the numeric field, NUM. 


_ “intelligent” compiler and only 
MMses those routines from the 
library that your program requires, 
and secondly, the entire library is 
written in Assembler, which 
makes the routines very small 
and very fast. 





Clipper ~FoxBase Quick 
(Fall '86) 2.6 Silver 7 





_ ” In the Index Size graph (below), the 
: : index files created by each product are 
i compared. As you can see, not only is 

F sie: III the fastest at indexing, it also 

creates the smallest index files! 

' {Tests conducted on an IBM 8Mhz. AT with 20Mb hard disk.) 
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Royalty Free and fully linkable! 
In addition to being the fastest true dBase 
compiler on the market, FORCE III 
‘generated .E XE files carry no royalties 


whatsoever! And FORCE Ill compiled §_ /# ‘Arrays, UDFs, sound, new functions, and more! 

programs can be linked to Borland’s Turbo {// Force III includes features you’ve come to expect in more expensive 
C and other C compilers using the Intel/ dBase compilers. For the programmer we have included I/O re-direction, 
_ Microsoft OBJ format. And linking to FOR-NEXT loops, C like file primitives, and new data types. We’ve 
_ Assembler is a snap. We even included an even included some Clipper compatible commands such as VALID. . 


ASCII graphics generator for easy screen _ = 
and menu generation. if ae ee = 
— | FORCE III comes with extras, like a 120 day warranty, an 

excellent reference manual and for the first 10,000 
customers, we'll include the premier sourcework, 


Advance dBASE III Plus Programming and 
Techniques by Miriam Liskin (a $21.95 
value). All this for just $129.00 (add $5.00 

_ s&h). In Colorado call 303-444-1542. In 
_ Europe call London at 44-1-631-0548. Or 
write: Sophco, Inc., PO Box 7430, Boulder, 
Colorado, 80306-7430. 
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Journal of Software Tools and you won't catch 
seepage ~ any nasty bugs again! 

Each month the Doctor brings you aid for 
ailing algorithms and the cure for common 
code. For the latest developments in 
software design and pages of code that will 
make you a more productive programmer, 
take the Dr. Dobb’s prescription. 
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elite have known Dr. Dobb’s Journal to be 
the foremost source of software tools. 
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OBJECT-ORIENTED PROGRAMMING 
(continued from page 30) 


and data manipulation in a single language, the objects 
in a GemStone database span the continuum between 
objects that correspond to values of variables in conven- 
tional programming languages and those that corre- 
spond to large design objects as may be found in VLSI 
databases. Conflict is unlikely on objects that corre- 
spond to program variables. For one thing, they are 
unlikely to be shared or persistent. Imposing pessimistic 
concurrency control on objects at this end of the 
continuum is an unnecessary burden. 

Optimism and shadowing allow GemStone to provide 
each transaction with a private workspace, within which 
the activities of other transactions cannot affect the 
transaction’s progress. At commit, privacy is abandoned, 
changes in the private workspace are made available to 
other transactions, and changes committed by other 
transactions become visible. Servio Logic Corp. realized, 
however, that in the case of large design objects, the 
amount of work that must be undone when conflict is 
detected may be unacceptable. They therefore began 
investigating supporting pessimism control in addition 
to optimism.* The goal was to make pessimism optional 
and, to as large a degree as possible, not of concern to 
applications that chose not to use it. Support for pessi- 
mism will be included in a forthcoming release. 

Concurrency control is one of the areas in which 
object-oriented data management offers great promise. 
Recent research efforts in programming languages have 
explored the notion of behavior-based concurrency con- 
trol. As a simple example, consider a savings account to 
which deposits are credited and withdrawals are deb- 
ited. There is no intrinsic reason why two transactions 
that are both crediting a given account need conflict. 
Neither transaction is concerned with the final balance 
after the credit. All they care about is that the proper 
amount is credited to the account; the order in which 
the amounts are credited is not of concern. Basically, 
each transaction adds the amount deposited to a list of 
credits to the account. The credits are processed in the 
order in which they were added to the list. That the 
credits were added to the list in the opposite order to 
that in which the two transactions committed has no 
effect upon the desired behavior. The read-write barrier 
of conventional systems prevents this form of concur- 
rency as the database has no knowledge of the seman- 
tics of operations beyond read and write. 


Large Objects and Large-Object Space 
Although relational systems can support a large number 
of tuples, they generally do not allow tuples to be larger 
than a page. Object-oriented systems must support large 
objects as well as a large numbers of objects. If large 
objects are not supported, application developers will 
have to encode large objects into objects no larger than 
those supported by the system. A GemStone system 
supports 23! objects (2°? counting instances of Smallinte- 
ger), and an object can contain 2° instance variables. 
When an object is, or grows, larger than a page, it is 
broken into pieces and is no longer stored contiguously. 
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Large objects can be accessed and updated without 
bringing the entire objects into memory. Large objects 
can also grow and shrink without copying the entire 
object. 

The basic data formats provided by an object-oriented 
system must support reasonably direct and efficient 
implementations of user-defined classes. Although rela- 
tional systems support both records (tuples) and sets 
(relations), arrays must be encoded. A data management 
system must support all three. 

The underlying basic storage formats must in turn 
efficiently support the basic data formats. GemStone 
supports five basic storage formats—self-identifying (for 
example, SmallInteger, Character, byte (for example, 
String), named, indexed, and nonsequenceable collec- 
tions. The byte format is used for classes whose in- 
stances may be considered unstructured. Structure is 
imposed by the methods that operate on the objects. 
The indexed format supports access to components of 
an object by integers, as in instances of Array. The byte 
and indexed formats support, without copying changes 
in the size of an object. The named format supports 
access by instance variable names. Classes whose in- 
stances have both named and indexed instance vari- 
ables are supported by a hybrid format. The nonse- 
quenceable collection (NSC) format supports collection 
classes such as Bag and Set. The members of such 
collections are not identified by name or index; instead, 
collections can be have members added, removed, or 
enumerated, and efficienlly support union, intersection, 
difference and tests for membership. 

Two other areas that need to be addressed by data 
management systems are clustering and associative 
access. Clustering is the placement of objects that tend 
to be accessed together near each other on the disk. The 
objects are placed on as few, preferably contiguous, 
pages as possible. By so placing the objects on disk, 
fewer disk accesses are required to bring these objects 
into memory. 

Consider the Employee object of Figure 1. If the 
clusterDepthFirst message were sent to the object, its 
layout on disk would be as in Figure 3, page 30. Since the 
ssNo, stNumber and Salary instance variables are 
selfidentifying, they are directly represented in their 
containing objects and need not be clustered. Now 
consider a collection of Employee objects. If enumera- 
tion of the elements of the collection occurs frequently, 
the elements can be clustered together. If these enu- 
merations tend not to access the addresses of employ- 
ees, it may be desirable to omit addresses from the 
clustering. The layout on disk of the employees would 
be as in Figure 4, page 30. By omitting addresses from 
the clustering, employees and their frequently accessed 
instance variables can be enumerated with even fewer 
disk accesses. OPAL’s clustering protocol is flexible 
enough to allow such clustering. 

An associative access is a search of a collection based 
upon the internal state of the collection’s elements—for 
example, a collection of employees can be associatively 
accessed for employees who live on a certain street. 
Even with clustering, searching large collections by a 
sequential scan may yield unacceptable performance. 
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OBJECT-ORIENTED PROGRAMMING 


(continued from page 33) 





Associative accesses should take time that is no more 
than logarithmic on the size of the collection. Hashing 
would allow the associative access of an employee with 
a particular social security number in nearly constant 
time, regardless of the size of the collection being 
searched. B-tree indexes support associative access in 
time that is logarithmic on the size of the collection and 
efficiently support range queries, such as locating those 
employees whose salary is within a given range. 

There are many issues with regard to associative 
access in object-oriented systems.° For example, should 
indexes index all instances of a class or only instances 
of explicit collections? How is the use of indexes to be 
indicated? Should indexes be based upon the structure 
or protocol of objects? If by structure, should indexes 
be on identity or value? GemStone supports B-tree 
indexes into explicit collections using the structure of 
objects. Both identity- and value-based indexing is sup- 
ported. A limited calculus sublanguage is provided to 
make use of indexes. The language was constructed so 
that associative queries may be viewed as procedural 
OPAL code. 


State of the Technology 

Object-oriented languages and data managment are 
emerging technologies. The first commercially available 
data management systems have only recently arrived on 
the scene. Deciding when and if to jump on the band- 
wagon is difficult. Strong interest in object-oriented 
systems, as indicated by the Conference on Object- 
Oriented Systems, Languages and Applications (OOPSLA) 
becoming ACM's third largest conference in just two 
years, is not sufficient. Other promising technologies of 
the past have failed to yield their expected benefits. 

If, however, you are encountering the frustration with 
structured programming I discussed in the introduc- 
tion, you might just browse through the proceedings of 
the OOPSLA conferences*® to see what advances are 
being made and the kinds of applications being devel- 
oped using object-oriented systems. You may well be 
surprised at the significant applications being devel- 
oped with object-oriented technology. GemStone, for 
example, is being used by an agency of the U.S. govern- 
ment to develop a new, automated coastal chart produc- 
tion and maintenance system. In this system, GemStone 
manages both the static feature information and the 
procedural knowledge to render that information into 
readable and reliable charts. At another U.S. government 
facility, dedicated to research in CIM, GemStone is being 
used to manage information flow between the many, 
often incompatible, systems involved in computer- 
integrated manufacturing. 

You may find that object-oriented technology is more 
mature than you thought. You might start asking hard 
questions about performance and how to compare 
object-oriented systems. Many argue that part of the 
price to be paid for the benefits of object-oriented 
systems is an apparent increase in the consumption of 
machine resources. It may well be the case, however, 
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that many applications can be developed using today’s 
technology and still yield adequate performance. After 
all, an application that can be developed quickly, that is 
easily maintained, and whose performance is adequate 
is often preferable to missed production deadlines, 
buggy code, and blazing performance. 

In the same manner as relational systems have mark- 
edly improved their performance over the last decade, 
so will object-oriented systems. Hardware will continue 
to get faster and cheaper. If performance isn’t quite 
adequate on the hardware you are running today, it will 
be tomorrow. 

Convinced? Want one? Which one? That may be a 
hard decision. For one thing, there is no single object 
model. In some models the collection of all instances of 
a class is meaningful; in others it isn’t. Some models 
support explicit deletion; others don’t. There are object- 
oriented extensions to C. Will these C extensions per- 
form better than systems whose heritage is Smalltalk? If 
so, there may be a price, such as the slower develop- 
ment and more difficult maintenance implied by a 
compile-and-link methodology. Perhaps what you really 
need is the EXODUS extensible database system being 
developed at the University of Wisconsin or the POST- 
GRES system being developed by Stonebraker and crew 
at Berkeley. 

What about benchmarks? A good set of benchmarks 
would make comparison shopping easier. There are 
problems too numerous to mention here. It’s difficult 
enough developing benchmarks for relational systems 
or any given programming language. It’s even harder for 
systems that integrate different language extensions 
with different object models. 

See you at OOPSLA. 

This article was condensed by the author from Develop- 
ment and Implementation of an Object-Oriented DBMS 
by David Maier and Jacob Stein. 
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A Dictionary is a collection of data pairs, much like an English language dictionary is a collection of term/defi- 


nition pairs. The “term” entry is the key and the “definition” entry is the value of the pair, or association. 





A Dictionary functions like a single-key database. This is how you create an object of class Dictionary with room 


for two key/value pairs: 


Workerl 


= new(Dictionary, 2); 


Next fill the dictionary with strings as keys like “Name” and “Age” and the corresponding values, the string 
“Sam Jones” and the integer 22. You are free to mix data types. 


Workerl ["Name" ] 
Workerl["Age"] : 


= "Sam Jones"; 
Zae 


Like a database, an Actor dictionary grows when you add to it more entries than you originally specified. Below, 
the dictionary grows from 2 to 4 as you add two more entries, or pairs: 


Worker1 ["Department"] 
Workerl ["Reviews"] 


:= #Engineering; 
= (55: to 98  94°5100)7 


Mixing data types allows great flexibility. You can even incorporate the above dictionary, Workerl, as a value in 


an entry of another dictionary, as in Employees below: 


Employees := new(Dictionary, 10); 
Employees["Sam"] := Workerl; 


Access the data in a dictionary by specifying the appropriate keys. The following statement returns the 


array #(85 73 98 100): 


AWorkersReview 


Employees ["Sam"] ["Reviews"]; 


You can also retrieve data from dictionaries by enumerating over the dictionary and extracting particular 
entries. Here is how to create a separate “database” of employees working in the Engineering department: 


Engineers := extract (Employees, 
; employee["Department"] == 


{using (employee) 
#Engineering}) ; 


Another feature allows you to create a new database incorporating only a subset of the original’s data. You do it 
by enumerating over a dictionary and collecting particular data about every entry: 


MailingList 





collect (Employees, 


{using (employee) 


employee ["Address"]}); 


Dictionary objects are available in Actor as ready-made units of functionality. They can be modified or special- 


ized for any application. However, as programmers, you are never involved in a dictionary’s physical implemen- 
tation or memory management. 





Technical Specifications 


¢ Runs with Microsoft Windows 1.x, 2.0 and 386. 

¢ Pure, single-inheritance object-oriented language, 
incrementally compiled. 

¢ Dynamic linking to C, Pascal, Assembler, or Fortran 
libraries. Pass data in C structures. 

¢ Pascal and C-like syntax. 

¢ Programming tools: Browser, Inspector, Debugger, 
File Editor. 

¢ Full access to MS-Windows systems calls, multi- 
tasking, and DDE. 

¢ Fast device-independent graphics: lines, shapes, 
icons, cursors, bitmaps, metafiles, Turtle graphics, 
sample control language using YACC. 

* 150 classes, 1500 functions, fully extensible. 

¢ Window styles: tiled, overlapping, popup, child, edit, 
dialogs. Controls: list boxes, scroll bars, buttons, 
check boxes. 

¢ Data structures: stacks, arrays, queues, lists, 
dictionaries, sets, sorting, hashing, intervals. 


¢ AI support: frames, symbols, dictionaries, lists, 
symbolic programming, functional arguments. 
Parsing and lexical analysis YACC compatible. 

¢ String manipulation: substring, concat, append, 
insert, remove, search. 

* 643-page manual includes tutorial and reference. 

* No license fees. Generates stand-alone applications. 

¢ Fastest interactive OOL available. 


Prices 


Actor $495 « Academic $99 * Academic site license 
$99 © Manuals for site license $35 * New! Language 
Extension I $99 ¢ Shipping $5 US, $25 Int'l 

Tech Support: Level 1 (20 phone calls) $100 ¢ Level 2 
(Developer’s package) $250 

Training Courses: 201 Intro. to Actor and OOP (2 
days) $395 © 202 Actor Developer’s Workshop (3 days) 
$795 © 203 Both 201 and 202 (1 week) $995 
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An Italic Font tn 





C tor the EGA 
and VGA 


A custom font for the EGA in Turbo C with source 
code for a resident program that makes the font 


software, which is one reason 
why so many developers pro- 
vide demonstration disks, often free. 
One thing that makes a program 
distinctive is having a custom type- 
face for the text that it displays. 
Until the advent of the EGA, this was 
a luxury reserved for programs that 
operated in graphics mode. 
Developing a nongraphics applica- 
tion to operate in graphics mode 
(for example, Framework in its EGA 
two-color graphics mode) is more 
costly than using the strong text 
mode support in the PC, however. 
Furthermore, prior to the EGA, graph- 
ics (with the exception of Hercules) 
were too poor to be very attractive. 
The EGA was such a rarity a year 
after its introduction that Peter 
Norton could write in his authorita- 
tive 1985 Programmers’s Guide to 
the IBM PC that “we won't be dis- 
cussing the 64-color palette of the 
EGA/ECD combo because it’s quite 
rare and specialized and doesn't 
really fit into the mainstream of the 
PC family” (page 77). 
This situation changed with the 
advent of EGA clones from Chips 


| Ee screen displays sell 


Andrew J. Chalk is president of 
Magna Carta Software, P.O. Box 
475594, Garland, TX 75047. 


permanent 


by Andrew J. Chalk 


and Technologies and others. At the 
present time, a no-frills EGA card 
sells for around $150 and will prob- 
ably cost around $100 before the 
end of 1988. At least for a while, the 
EGA will be the de facto video stan- 
dard, so it behooves developers to 
take advantage of its special features. 

In this article I show how to ex- 
ploit one of the interesting features 
of the EGA—the ability to replace 
the standard character font in text 
mode with one of your own choos- 
ing. As an example, I use an italic 
font and provide source code for a 
TSR that loads the font into RAM so 
that DOS and (most) application pro- 
grams can use it. The TSR is neces- 
sary because the EGA reloads the 
ROM character set when the video 
mode is changed. By intercepting 
the BIOS for video mode changes, 
you can reload your custom font in 
its place. The TSR can be deinstal- 
led, freeing up the 17K of memory it 
occupies for other programs and pre- 
venting incompatibilities. 

The source code is written in C 
(Borland International's Turbo C, to 
be precise), so this article also serves 
a second purpose—explaining some 
of the techniques for writing resi- 
dent code in high-level languages. 
As I will explain later, I have con- 
cluded that this is basically a bad 


idea. If the on-line services and bul- 
letin boards are good indicators, how- 
ever, it is a subject of great interest, 
so it is worth spreading the tech- 
niques just so that others can 
become similarly disabused of the 
practice. 

In order to use the code included 
here, you first need to understand 
fonts on the EGA. Then I'll talk about 
the C implementation in the source 
code. After that I'll discuss the TSR 
aspects of the source code and why 
you should write TSRs in assembly 
language. 


Fonts on the EGA 
Programmers writing for the mono- 
chrome display adapter (MDA) and 
the color graphics adapter (CGA) are 
stuck with the character sets pro- 
vided in those board’s ROMs. If you 
want a different character set, say as 
users of APL do, you have to replace 
the ROM. On the EGA, things are 
different. The fonts are ‘‘soft,’’ mean- 
ing that although the ROM charac- 
ter generator is used by default, it 
can be replaced by a character set 
of your choosing. In fact, the EGA 
can support four character sets in 
what IBM calls four different blocks. 
Normally, you use block 0. 

The EGA has BIOS support for the 
loading of an alternate character set 
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through interrupt 10h, function 11h, 
subfunction 0. You make a call to 
this function with ES:BP pointing to 
a table containing your font (in a 
format I will explain), DX set to the 
ASCII ordinality of the first character 
in your character set, CX set to the 
number of characters in your char- 
acter set (maximum 100h), BH set to 
the number of bytes per character, 
and BL set to the block to load 
(usually 0). These parameters pro- 
vide the BIOS with sufficient infor- 
mation to load your font because of 
the way that fonts are stored. 

Figure 1, below, shows a letter g 
as a magnified version of its screen 
image and as a stored character in 
memory. The figure assumes an en- 
hanced color display in 25-line 
mode, in which case each character 
is 14 scan lines high and 8 pixels 
wide. A 25-line screen therefore fills 
14 Xx 25, or 350 scan lines, as does 
the EGA. On the monochrome dis- 
play, a 14x 9-character box is used, 
and on the regular color display, the 
CGA 8 X 8-character box is used. The 
43-line mode that is popular on the 
EGA driving an enhanced color or a 
monochrome display is achieved by 
loading the 8X 8 ROM character set 
(because 8 X 43 is 344, just less than 
the 350 scan lines available). BIOS 
support exists for this, too, although 
two bugs in the original EGA BIOS 
make its implementation too big a 
subject to digress into here. 

Let's assume that the EGA is driv- 


ing an enhanced color display. In 
this case, each character is 14 scan 
lines high and 8 pixels wide. Repre- 
senting this in RAM is simplified by 
the fact that each pixel that forms 
part of a character can be consid- 
ered to be either “on” or ‘off’ when 
a given character is on the screen. 
This means that the state of each 
pixel can be represented in binary 
by 1 bit. Furthermore, the designers 
of the EGA seem to have chosen a 
character width of 8 because this 
permits each character-scan line to 
be represented by exactly 1 byte. 

In Figure 1, the hexadecimal 
values of each scan line are shown 
above the character. The arrows that 
lead in the direction of memory 
show that the letter g is stored as 14 
contiguous bytes of data. Because g 
has an ASCII value of 67h, the char- 
acters next to it are the ASCII values 
66h and 68h. The latter of these is h. 

When you load a custom font into 
the EGA, you tell the BIOS, through 
ES:BP, the address of a buffer con- 
taining your chosen characters. If 
you want to load a complete charac- 
ter set, this buffer is 3,584 (14 x 256) 
bytes long. The EGA lets you load 
fewer than 256 characters, and it 
lets you choose the starting position 
in the ASCII sequence. The sequence 
of characters for any one load opera- 
tion must be consecutive members 
of the ASCII character set, however, 
or you will get garbage on the 
screen. 


Figure 1: EGA character representation on the screen and in memory 
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Note two important limitations of 
the EGA font features. First, charac- 
ters have a fixed width (but may 
vary from 1 to 32 scan lines high), 
so you do not have the same flexibil- 
ity as in graphics modes. Second, 
although your 14 X 8 fonts work fine 
on a monochrome monitor in 25- 
line mode, a different character set 
is required if you support different 
numbers of screen lines. Suppose, 
for example, you were going to in- 
corporate a feature into a database 
such that the user could press a hot 
key and immediately switch into 43- 
line mode and thereby see more 
records in ‘table view.” If you had a 
custom typeface, you would need a 
43-line-mode equivalent of it that 
would be loaded at the same time. 

Notwithstanding these limitations, 
the custom font capability of the 
EGA is impressive. As I stated ear- 
lier, a video mode reset restores the 
ROM character set, so your applica- 
tion should perform a reload opera- 
tion every time it performs a video 
mode reset. Furthermore, if you 
want to load your custom fonts only 
in certain video modes, you should 
check the video mode before load- 
ing. The example program ITALIC.C 
in Listing One, page 50, only loads 
the custom character set in modes 
0-3 (text modes) and 7 (mono- 
chrome). 


A Resident Italic Font 
The example program consists of 
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ITALIC FONT IN C 
(continued from page 37) 


two parts: ITALIC.C is the source 
code, and ITALIC.ASC (Listing Two, 
page 52) contains the code for the 
font in a form I will explain shortly. 

The program first checks the 
system configuration to see _ if 
custom fonts are supported. This is 
done by means of the function 
get__video__info(), which first 
checks for the presence of an EGA 
in the system through the recom- 
mended BIOS call (function 12h). If 
an EGA is not present, the value of 
BL is returned unchanged, in which 
case you exit with a message ex- 
plaining to the user that an EGA is 
required. There is a practice in the 
literature of checking for the IBM 
signature in the EGA BIOS. Not only 
is this kludgy but it is also specifi- 
cally disapproved of in the EGA BIOS 
listing. 

It is not enough to know that an 
EGA is present—it must also be 
active. The user may, for example, 
have an EGA driving.a color monitor 
and an MDA driving a monochrome 
monitor and be using the MDA. To 


see if the EGA is active, you check 
that bit 4 of the EGA information 
byte in the ROM data area at 0:0487h 
is 0. If not, you exit with a message 
to the user explaining that the EGA 
must be active. : 

If space had permitted, I would 
have included code to save the video 
configuration and switch adapters. 
The saved information could then 
be used to restore the ex ante state 
of the machine on exit. For the same 
reason, I have also omitted code to 
detect a switch of adapters while 
ITALIC is resident. Be warned: 
ITALIC illustrates a technique; it is 
not a full-blown professional pro- 
gram. 

Having determined that an EGA is 
active, you then determine whether 
it drives a monochrome or a color 
monitor. The value of BH is 1 if 
monochrome and 0 if color. The 
result is used to set the global vari- 
able ega_color appropriately. If a 
color monitor is in use, you test for 
an enhanced color display. If it’s not 
present, you exit with an explana- 
tory message because the EGA will 
use the 8 X8 font on a regular color 
display and my example requires 14 
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scan lines per character. 

If the system checks out, you 
return to main() and set the video 
mode based on the type of monitor 
in use. You then check whether a 
copy of the program has already 
been installed. This involves scan- 
ning down through memory from 
the program segment prefix (PSP) for 
two identification words inserted in 
the global data area near the top of 
the program. These words are 
our__id1 = FACh and our__id2 = 
1000h. The function already__in- 
stalled() first peeks at the offset of 
our__id1 with the segment value 
equal to 1 less than the PSP. The 
segment value is then decremented 
until 0 is reached or a match is 
found. If a match is found, the next 
word is peeked at and compared 
with our__id2. If you assume that all 
characters are equally likely, the 
chance of erroneously concluding 
that ITALIC is resident when it is 
not if you load halfway up memory 
on a 640K machine is 1 in 13,158. If 
you are uncomfortable with this, 
you can lengthen the odds by search- 
ing for more than two words. 

If you find a copy of ITALIC, you 
deinstall it and print a message tell- 
ing the user. The mechanics of dein- 
stalling a resident program are ex- 
plained in the next section. If ITALIC 
is not present in memory, you can 
proceed with installation. There are 
three distinct phases of this process. 

First, you only want to replace the 
alphanumeric characters in the 
ASCII set. Box-drawing characters 
simply don't draw boxes if they are 
italicized. My strategy is to load a 
copy of the whole 14 x 8 ROM char- 
acter set into the buffer fontarray 
and then load only the alphanu- 
meric characters from the data file 
ITALIC ASC. The advantage of this is 
that your .EXE file need not be swol- 
len with unnecessary data for char- 
acters that do not differ from the 
ROM 14 X 8-character set. Retrieving 
the ROM character set is easy thanks 
to BIOS support and is accom- 
plished in get_egafont(). Next, a 
for() loop overlays the ASCII charac- 
ters 32 through 127 with italic char- 
acters. 

If you refer to the listing of 
ITALIC.ASC, you find that the italic 
font data is set up as a two-dimen- 
sional array with each row consist- 
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ing of the appropriate hexadecimal 
values for a single character. The 
listing shown is actually the output 
of FONTEDIT, a full-screen, real- 
time EGA font editor included in C 
Windows Toolkit (see the ‘“‘Availabil- 
ity” section at the end of this arti- 
cle). Don’t worry about typing the 
listing; download details are given 
at the end of the article. 

The second stage is the loading of 
your font (telling the EGA to use it) 
using interrupt 10h, function 11h, 
as described earlier. This is accom- 
plished by the function load_— 
user__egaxfont(). At this point the 
screen display immediately changes 
to reflect the new font. 

The third stage is the resident 
installation of a replacement inter- 
rupt handler for interrupt 10h so 
that you can detect video mode 
changes and reload your font if nec- 
essary. First, you save the PSP and 
environment pointer in the PSP at 
offset 2ch to use for later deinstalla- 
tion. Next, you save the old inter- 
rupt 10h address using getvect() 
and install your own handler with 
setvect(). Finally, you terminate and 
stay resident (more on this in the 
next section) 














The new font affects every charac- 


ter on the screen. The italic font 
presented here is probably not dis- 
tinct enough for serious text work, 
but it could be edited to be so. The 
italic font in Microsoft Word is cre- 
ated through exactly the same kind 
of techniques. Other fonts along the 
lines of the large selection supplied 
with the Hercules Graphics Card 
Plus that are practical fonts for text- 
intensive work are also possible. 





Programming Resident 
Programs in High-Level 
Languages 

As I stated in the introduction, the 
experience of writing this (simple) 
TSR in C has lead me to conclude 
that such programs are best written 
in assembly language. There are sev- 
eral reasons for this. Perhaps the 
most important one is the sheer 
size. ITALIC occupies 13K RAM, of 
which 3,585 bytes are the font buffer, 
1,344 bytes are the replacement font 
data, less than 100 bytes are for 
other global data, and 512 bytes are 
for the .EXE header. The remaining 


11,500 odd bytes are “code.” It is 
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this portion that assembly language 
could shrink down to perhaps 3,000 
bytes (I have not done it for this 
program). A second reason in favor 
of assembly language is the irrele- 
vance of the portability issue. 

An argument often legitimately 
raised in favor of high-level lan- 


It can hardly be 
argued that the 
problems arose 
from the choice 
of language. 


guages is their advantage in terms 
of development time. In fact, for resi- 
dent code, even given that I was 
working without the benefit of a 
large literature on the ins and outs 











of programming TSRs in high-level 
languages such as exists for assem- 
bly language, so many problems re- 
sulted from having a compiler be- 
tween me and the machine that I 
spent a lot of time inside the debug- 
ger. Assembly-language TSRs are 
easier to debug. 

It can hardly be argued that the 
problems arose from the choice of 
language. Wasn't it the low-level 
links that made C so popular as an 
application language? It is also diffi- 
cult to argue that the choice of com- 
piler was the problem. Turbo C has 
library support for all the function 
calls associated with resident code. 
Although it lacks a built-in debugger 
at the time of writing, Periscope 
does an admirable job. In-line as- 
sembly language is also available, 
but the objective here was to not 
use a single line of in-line code (that 
isn't really writing a TSR in a high- 
level language). 

It might be argued that program- 
ming TSRs obviates the need to 
learn assembly language. The last 
person I would recommend to write 
a TSR in a high-level language is 
someone who did not know assem- 
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ITALIC FONT IN C 
(continued from page 39) 


bly language. Ironically, the alleged 
portability of C code to different com- 
pilers (because it is a high-level lan- 
guage) becomes the opposite with 
TSRs. Because the generated code 
differs across compilers, code that 
runs flawlessly compiled with one 
compiler can produce subtle and 
hard-to-track bugs on another. The 
truly ‘‘safe’” code becomes the one 
that is “immune” from portability 
virtues—assembly language. 

These objections aside, here is 
how you implement a simple resi- 
dent program in Turbo C. Bear in 
mind that this program does not 
access the disk or the keyboard, so 
many TSR techniques are not dis- 
cussed. For a fuller treatment I rec- 
ommend Turbo C: The Art of Ad- 
vanced Program Design, Optimiza- 
tion and Debugging by Stephen 
Randy Davis. I have no doubt that 
ITALIC could be implemented more 
efficiently in C than I have done 
here, but the relevant question is 
how these improvements compare 
with the real alternative—assembly 
language. 

First, consider the way that you 
would implement this TSR in assem- 
bly language. Near the top of the 
source code would be the resident 
section, preceded by a jump to the 
installation section, which you 
would jettison when the resident 
part was installed. In C you perform 
the same installation steps of saving 
the old interrupt 10h vector and 
installing your own. 

A problem arises when you wish 
to terminate and stay resident. 
Turbo C contains the keep() func- 
tion, which implements interrupt 
21h, function 31h, and requires the 
number of paragraphs of memory to 
reserve as one of its parameters. 
Whereas this is simple to compute 
in assembly language, it is not so in 
high-level languages generally or in 
Turbo C in particular (the Turbo C 
manual does not even mention this 
problem). 

The method I used in ITALIC was 
discovered by Dean McCrory and 
generously posted by him on Com- 
puServe. Turbo C uses two internal 
variables: __psp (to contain the PSP 
address) and ____brklvl (to contain 
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the address of the end of the initial- 
ized and uninitialized data). As 
memory is dynamically obtained 
and released, ____brklvl is adjusted 
accordingly. If you visualize Turbo 
C memory allocation as in the dia- 
gram for the small model in the 
User's Guide (that is, the data seg- 
ment follows the code), then adding 
____brklvl to DS and subtracting the 
PSP address gives the size of the 
code and data. That is what I do in 
the keep() statement at the end of 
main. 

Although this is ingenious, you 
should be aware of some potential 
problems and limitations. First, this 
will not work in the large data 
models (compact, large, and huge). 
Second, I do not know what hap- 
pens, but you must presumably not 
farmalloc() any memory you wish 
the resident program to use. Third, 
this is undocumented and should 
be considered not fully tested. 

The other part of the TSR code is 
the deinstallation routine, including 
the deallocation of the program's 
memory. This practice appears to 
be little known in both C and assem- 
bly language (it is certainly not offi- 
cially documented). It probably en- 
hances the value of a TSR to the 
user if it is removable, however. 

The first thing you do is restore 
interrupt 10h to its original value. 
Next, you must deallocate memory. 
Deallocating the space occupied by 
a resident program is as easy in C 
as in assembly language, and the 
technique is the same. You must 
remove the program itself and its 
copy of the environment. In order 
to do so, when you first load the 
TSR, you must store the PSP and the 
contents of the environment pointer, 
which is located at offset 2ch in the 
program's PSP. 

When you try to install ITALIC, 
already__installed() finds a match 
and stores the data segment ad- 
dress of the installed copy in the 
global variable old__ds. When you 
deinstall the program, you peek at 
old__ds, offset by the address of 
old__psp to get the PSP, and then 
you repeat this using the offset of 
old__env to get the environment ad- 
dress. Next, you deallocate the pro- 
gram memory using interrupt 21h, 
function 49h. ES must hold the ad- 
dress of the installed program's PSP. 
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Finally, you repeat this function call 
with ES pointing to the installed 
program's copy of the environment. 

It is instructive to run CHKDSK 
before and after installation to con- 
firm that this procedure works. I 
have found it to be reliable, but TSRs 
are a world without rules. 


Summary 

The techniques for loading custom 
fonts described here give a program 
an edge of distinctiveness in an ever 
more crowded software marketplace. 
Not only is this now worthwhile for 
developers because of the greater 
abundance of EGAs but the code 
also works on the VGA. This means 
a fairly long time span for the invest- 
ment in program development to 
pay off. Graphics environments offer 
users custom fonts, but program de- 
velopment is longer. The custom 
font facilities of the EGA offer a faster 
development path that does not re- 
quire the wholesale recoding of ap- 
plications. 


Availability 
All the source code for articles in 
this issue is available on a single 
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Ease of traversal is the major advantage of a 


ture called a threaded binary 

tree that combines the quick 
random lookup qualities of a binary 
tree with the easy traversal of a 
linked list. This data structure pro- 
vided a clean and reasonably ele- 
gant solution to an application pro- 
gram I was developing. In this arti- 
cle I describe how to create and 
traverse threaded binary trees and 
provide a set of functions written in 
Microsoft C that illustrate how I im- 
plemented this data structure in my 
application. : 

I'm the type of programmer who 
likes to tinker with programs just to 
see how they work. That particular 
personality trait recently lead me to 
work on an interactive spelling 
checker for the letters and docu- 
ments I write (it certainly would 
have been more cost-effective simply 
to buy a spelling checker). 

The spelling checker required a 
data structure that would allow all 
the unique words in a document to 
be identified and then retrieved in 
sorted order for comparison with 
the dictionary. I knew that a binary 
tree would be a fairly efficient way 
of identifying and sorting the unique 


| ore discovered a data struc- 
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threaded binary tree. 


by James Mathews 


words in a single step, and methods 
of building and traversing binary 
trees are well known and docu- 
mented. 

However, I also wanted the ability 
to scan back and forth interactively 
in the list of words not found in the 
dictionary and select whether a par- 
ticular word was to be added to the 
dictionary, marked as misspelt, cor- 
rected interactively, or simply ig- 
nored. And here is where I ran into 
trouble with a binary tree—all my 
solutions to moving back and forth 
interactively to selected nodes in the 
tree involved more code. than 
seemed necessary or reasonable. At 
one point I even considered convert- 
ing the binary tree to a doubly 
linked list once the (possibly) mis- 
spelled words were identified, just 
to facilitate scanning back and forth 
over the words. 

And then, while browsing though 
Fundamentals of Data Structures by 
Horowitz and Sahni,’ I came across 
a description of threaded binary 
trees. Great, a threaded binary tree 
seemed to be just what I needed. 

Each node of a binary tree typi- 
cally contains pointers to left and 
right child nodes. If a_ particular 
node does not have a left or right 
child, the corresponding pointer has 
a null value. In fact, it turns out that 





slightly more than half of the point- 
ers in any binary tree will be null. 
For a binary tree with N nodes, there 
are 2N pointers (two per node) and 
N+1 of those pointers will be null 
(refer to Horowitz and Sahni or an- 
other text for a discussion about 
why N+1 pointers are null). 
Threaded binary trees differ from 
other binary trees in that the null 
pointers to nonexistent left and right 
child nodes are used as “threads” 
to point to prior and successor 
nodes in the tree. Using the (other- 
wise) null pointers as threads to 
prior and successor nodes allows a 
threaded binary tree to be traversed 
in order almost as easily as a linked 
list while retaining the quick lookup 
of a binary tree. Figure 1, page 43, 
illustrates (a) a standard binary tree 
and (b) the same tree with the null 
pointers replaced by threads. 


The Code 

Listing One, page 58, shows a C 
language header file (tbtree.h) that 
defines a TREE__NODE structure con- 
taining some of the fields used by 
my spelling checker application. A 
node is created in the threaded 
binary tree for every unique word 
found in the document being 


checked. Each TREE__NODE con- 
tains a pointer to the node’s word 
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(stored as a null-terminated string), 
an integer used to hold flag values, 
a usage count indicating how many 
times the word appears in the docu- 
ment, and pointers to left and right 
child nodes. 

When traversing a threaded tree 
structure, it is necessary to know if 
a particular pointer field contains 
the address of a child node or if the 
pointer field contains a thread to a 
prior or successor node. The 
tbtree.h header file also defines two 
flags, RBIT and LBIT, which indicate 
if the right and left child pointers 
contain valid child node addresses 
or if they contain threads to other 
nodes. If the RBIT flag is set in a 
node, then that node has a right 
child node; if RBIT is not set, the 
right child pointer is a thread. Simi- 
larly, the LBIT flag identifies the 
usage of the left child pointer. 

Notice that the RBIT and LBIT 
flags are the only extra storage re- 
quired in the tree nodes. The 
threads occupy the right and left 
child pointers that would otherwise 
have been left null. Knuth* suggests 
that even these flags could be elimi- 
nated if a child node always resides 
at a higher memory address than its 
parent—a child node would have a 
higher address than the current 
node, whereas a thread would 
always contain a lower address. In 
my application, I chose to play it 
safe and added the two 1-bit flags. 
Because I already required a group 
of other flags for each node, these 
additional flags did not increase the 
size of a node. 

tbtree.c in Listing Two, page 58, 
shows the routines I created to 
build and traverse a threaded binary 
tree. The function add2tree() adds a 
new word to the tree each time it’s 
called provided the word doesn't 
already exist in the tree. add2tree() 
compares the prospective new word 
to existing nodes in the tree until it 
either locates a node already con- 
taining that word or it locates a 
node to which the new word should 
be added as a right or left child. If 
the word already appears in the tree, 
add2word() simply increments the 
word's usage count and exits. If the 
word needs to be added to the tree, 
add2tree() invokes the linsert() or 


a left or right child, respectively. 

Functions linsert() and rinsert() 
implement the logic required to add 
a node to a threaded binary tree. 
Notice that these routines are actu- 
ally quite simple. To add a new left 
child node, the new node is given 
the left child pointer from the 
parent node, the new node's right 
child pointer becomes a thread back 
to the parent, and the new node is 
linked to the parent as a left child. 
Function rinsert() is an equally 
simple implementation to add a 
right child to a node. 

I should point out that the lin- 
sert() and rinsert() routines call func- 
tion talloc() to allocate the memory 
for a new node. The first implemen- 
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tation of these routines called the 
standard malloc() library routine to 
allocate memory, but in analyzing 
the performance of the program on 
large documents, I found that 
malloc() was by far the largest con- 
sumer of CPU time. I therefore cre- 
ated the talloc() function to allocate 
tree nodes more efficiently. For rela- 
tively small tree structures, malloc() 
could certainly be used without no- 
ticeable degradation. 

The functions shown in Listing 
Two require the presence of a spe- 
cially initialized root node (although 
its structure is the same as that of 
any other node). The add2tree( ), lin- 
sert(), and rinsert() functions build 
the threaded binary tree as a left 


(a) Standard binary tree with null points 


binary 


standard 


(b) Threaded binary tree with root node—shown as dashed lines. 
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rinsert() function to add a node as Figure 1: Standard and threaded binary trees 
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Introducing the two 





on earth 


The new COMPAO DESKPRO 386/20" 


The world now has two new 
benchmarks from the leader 
in high-performance personal 
computing. The new 20-MHz 
COMPAQ DESKPRO 386/20 and 
the 20-lb., 20-MHz COMPAQ 
PORTABLE 386 deliver system 
performance that can rival 
minicomputers’. Plus they intro- 
duce advanced capabilities 
without sacrificing compatibil- 
ity with the software and hard- 
ware you already own. 


Both employ an industry- 
standard Intel’ 80386 micropro- 
cessor and sophisticated 32-bit 
architecture. Our newest porta- 
ble is up to 25% faster and our 
desktop is actually up to 50% 
faster than 16-MHz 386 PC's. 
But we did much more than 


simply increase the clock speed. 


For instance, the COMPAQ 
DESKPRO 386/20 uses a cache 
memory controller. It comple- 
ments the speed of the micropro- 


cessor, providing an increase in 
system performance up to 25% 
over other 20-MHz 386 PC's. It's 
also the first PC to offer an op- 
tional Weitek™ Coprocessor Board, 
which can give it the performance 
of a dedicated engineering work- 
station at a fraction of the cost. 

They both provide the most 
storage and memory within their 
classes. Up to 300 MB of storage 
in our latest desktop and up to 
100 MB in our new portable. 
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It simply works better. 
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and the new 20-MHz COMPAQ PORTABLE 386" 


Both use disk caching to inject 
more speed into disk-intensive 
applications and both will run 
MS’ OS/2. 

As for memory, get up to 16 MB 
of high-speed 32-bit RAM with 
the COMPAO DESKPRO 386/20 
and up to 10 MB with the COMPAQ 
PORTABLE 386. Both computers 
feature the COMPAQ’ Expanded 
Memory Manager, which supports 
the Lotus’/Intel’/Microsoft* Ex- 
panded Memory Specification 


to break the 640-Kbyte barrier 
imposed by DOS. 

With these new computers 
plus the original COMPAQ 
DESKPRO 386™. we now offer 
the broadest line of high- 
performance 386 solutions. 
They all let you run software 
being written to take advantage 
of 386 technology, including 
Microsofte Windows/386 Presen- 
tation Manager. It provides 
multitasking capabilities with 


today's DOS applications to 
make you considerably more 
productive. But that's just the 
beginning. For more informa- 
tion, call 1-800-231-0900, 
Operator 43. In Canada, call 
416-733-7876, Operator 43. 





Intel, Lotus, Microsoft, and Weitek are 
trademarks of their respective companies. 
©1987 Compag Computer Corporation. 
All rights reserved. 
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subtree of the root node. An empty 
threaded binary tree consists of just 
the root node. 

The root node contains a data 
value that is higher than that of any 
other node in the tree (I chose the 
ASCII. character as the root node’s 
word value because . is numerically 
greater than any uppercase or lower- 
case alphabetic character). This 
avoids’ special code in_ the 
add2tree() function for dealing with 
the root node. 

The right and left child pointers 





Add C++ to 
your favorite 
C Compiler 
¢ Object-oriented C 


° Strong type-checking 


° Works with your 
present C Compiler 


and the RBIT and LBIT fields in the 
root node are initialized such that 
the root node becomes the in-order 
predecessor of the lowest-valued 
tree node and the in-order succes- 
sor of the highest-valued node. Trav- 
ersing the tree from start to finish 
begins and ends at the root node. 
The definition of the root node 
occurs in Listing Two just prior to 
the add2tree() function. 

Function inorder__succ() (also in 
Listing Two) returns the in-order suc- 
cessor of any node in the threaded 
binary tree. To find the successor 
node, inorder__succ() looks at the 
right child of the starting node. If 
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the right child pointer is a thread, 
then it points to the successor node 
and inorder__succ() simply returns 
that node address. If the starting 
node has an actual right child node, 
however, the successor is the left- 
most child of the starting node’s 
right child. The leftmost child is 
located by a simple while statement 
that moves down the list of left child 
pointers. 

Function inorder__pred() corre- 
spondingly locates the in-order 
predecessor of any node in the tree. 
inorder__pred() returns the starting 
node's left child pointer (if it’s a 
thread) or the rightmost child of the 
starting node's left child. 

To perform an in-order traversal 
of the entire threaded binary tree, 
you need only make successive calls 
to inorder__succ() (for nodes in as- 
cending order by data value) or inor- 
der__pred() (descending order by 
data value). The following few lines 
of code, for example, would print 
out all the words in the tree in 
ascending order: 


TREE__NODE “tp; 


tp = &root; /* start at root */ 

while ((tp = inorder_succ(tp)) != 

&root) /* end at root */ 
puts(tp—>word); 


In Summary 

Ease of traversal is the major advan- 
tage of a threaded binary tree. There 
are other well-known algorithms for 
traversing binary trees, but some of 
those require the use of recursion 
or an auxiliary stack to maintain the 
current location within the tree. Re- 
cursive algorithms and those that 
use an auxiliary stack require addi- 
tional memory above and beyond 
the requirements of the tree itself. 
For applications in which the size 
and structure of the tree is not 
known beforehand (such as a spell- 
ing checker), trying to ensure that 
sufficient memory exists for the pro- 
gram or auxiliary stack can be diffi- 
cult. Because threaded binary trees 
use the otherwise null pointers as 
threads, this type of tree can be 
traversed without additional run- 
time storage. 

There are other algorithms that 
can traverse a binary tree without 
recursion or the use of an auxiliary 
stack, but they typically require the 
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What They Don't Teach You 
About TSR's And ISR's At MIT 


When our customers started asking for a 
resident communications program I| thought 
it would be a piece of cake. I was surprised 
by how little I really knew about interrupt 
calls to DOS and their attendant dangers. 


Catch-22 


The real Catch-22 is that TSR’s are multi- 
programming in a very real sense, and MS- 
DOS was never presented to the public as 
multi-anything. 


All things considered, they would still be 
elementary if all you had to do was issue 
system bios calls, such as interrupts 10h, 14h, 
17h, 16h, etc. But, I’m getting ahead of 
myself. 


The secrets of TSR’s and interrupts are 
closely guarded by the companies that 
develop them. So coming up with any solid 
information can be frustrating. 


Fear Of Terminating 


After spending many sleepless nights in 
front of a CRT using all the tricks of the 
trade, including help from the Periscope III 
Debugger, the project was completed. I had 
lost my fear of terminating and staying 
resident. 


In the process I became familiar with a 
couple of powerful, undocumented DOS 
interrupts that Microsoft had tucked away 
for their own use. 


In addition, there were some gross misun- 
derstandings about other functions listed on 
the better BBS’s. Even some of our own 
functions from Essential Communications 
had to be wired together in new ways. 
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When I was finally done, I recognized that 
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devising a method for making any C 
program memory-resident and well-behaved. 
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(continued from page 46) 





addition of a parent node pointer 
field to each node or the temporary 
reversal of the direction of the 
pointer fields and the addition of a 
flag to indicate if a particular node 
has already been processed. The 
linked list approach of a threaded 
binary tree is conceptually simpler 
and easier to implement. 

Threaded binary trees are not a 
new form of data structure. They 
were documented in 1960 by Perlis 
and Thornton?’ and are discussed 
by Knuth? in his The Art of Com- 
puter Programming series. Threaded 
binary trees do not seem to have 
received the widespread recognition 
or usage that other forms of binary 
trees have achieved, however. I was 
prompted to write this article in the 
hope that I could introduce (or pos- 
sibly reintroduce) the concepts to 
others who might find them useful. 


Availability 

All the source code for articles in 
this issue is available on a single 
disk. To order, send $14.95 to Dr. 
Dobb's Journal, 501 Galveston Dr., 
Redwood City, CA 94063, or call (415) 
366-3600, ext. 216. Please specify the 
issue number and format (MS-DOS, 
Macintosh, Kaypro). 
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1. Ellis Horowitz and Sartaj Sahni, 
Fundamentals of Data Structures 
(Rockville, Md.: Computer Science 
Press, 1982). 

2. D. Knuth, The Art of Computer 
Programming: Fundamental Algo- 
rithms, Volume I, 2d ed (Reading, 
Mass.: Addison-Wesley, 1973). 

3. A. Perlis and C. Thornton, “Symbol 
Manipulation by Threaded Lists,” 
Communications of the ACM, vol. 3, 
no. 4 (April 1960): 195-204. 
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Listing One (Text begins on page 36.) 
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ITALIC.ASC -- This is an ASCII representation of the italic font 
characters used in ITALIC.c. 


In the table below, each row corresponds to a character. 


This file is #includepD. 


The 


14 elements of each row correspond to the 14 scan lines of the 
character. 
char italic arr[128-32][14] = { 
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(YW High-speed compilation @ ANSI compiler and library 
'W High-performance code [WW Full-screen library 
YW Reentrant code options WW Full-screen symbolic debugger 


W OS linkage options 


W In-line functions 


WATERLOO C Version 3.0 is the 
high-performance development system 
for IBM 370 mainframe architectures 
under VM/CMS consisting of: 


¢ Optimizing C Compiler 

e C Run-time Library 

e Interactive Source-level 
Debugger 

e Development Tools 


WATERLOO C is ideal for new soft- 
ware development and for porting existing 
software to IBM mainframes. It provides 
ANSI standard support in an integrated 
CMS environment for portability and effi- 


ciency. And it puts all the resources of a full 


development system at your fingertips so 
you can quickly achieve quality results. 


WATERLOO C improves your 
response time and conserves your main- 
frame resources with an extremely fast 
compilation rate. A single phase from 
source to object means less overhead, 
while both the compiler and library can 
reside in shared segments for even faster 
compiles and links. 


WATERLOO C generates the highest 
quality code with an exclusive state-of-the- 
art optimizer. Options for reentrant applica- 


tions and OS linkage conventions mean 
flexibility in development. Moreover, a 
convenient option allows you to see the 
original source lines as comments in the 
assembler output. 


The source-level debugger lets you 
work with your programs the way you 
wrote them. The full-screen interface feels 
so natural that it is easy to use. Debugging 
activity is performed using source varia- 
bles, functions, and lines. And 
the execution environment 
allows stepping, breakpoints, 
tracing, and display and alter- 
ation of your program data. 


3 Waterco © 
VIA/SP CMS 
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IBM is a trademark of the International Business Machines Corporation. © Copyright 1987 WATCOM Products Inc. le ——r 





W Extensive on-line documentation 
iW Development tools 





WATERLOO C 33.0 full-screen debugger: A quick route to quality results. 





Completing the development environ- 
ment are these important productivity 
tools: 


¢ Update your programs with a single 
command: MAKE. 

e Simplify multi-file maintenance with 
GREP and DIFF. 

e Track source variables and functions with 
cross-reference utilities. 

¢ Spot performance bottlenecks with a 
program execution profiler. 
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e Please send your product 


A full support framework provides com- a : 
i: information package. 


plete technical backup. Access documen- 
tation easily on-line or in comprehensive 
reference manuals. Our Customer Support 
Center provides you with expert technical 
assistance. Newsletters keep you informed 
about product developments. And on-site 
installation and training workshops are 
available. 


[| | would like to arrange for an 
evaluation copy. 

a Name: 

| Title: 
g Company: 
= Street: 
. City: 








s State: Zp: 
Telephone: 





Dept. DDO3A 
| 415 Phillip Street 
Waterloo, Ontario, pigeons N2L 3X2 


Tel. (519) 
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Listing One (Listing continued, text begins on page 34.) 


/* Font character 116 (ASCII value t 
/* Font character 117 (ASCII value 
/* Font character 118 (ASCII value 
/* Font character 119 (ASCII value 
/* Font character 120 (ASCII value 
/* Font character 121 (ASCII value 
/* Font character 122 (ASCII value 
/* Font character 123 (ASCII value 


is */ {0x00, 0x00, 0x04, Ox0c, 0x18, Ox7e, 0x30, 0x30, 0x60, Ox6c, 0x70, 0x00, 0x00, 0x00}, 
is */ {0x00, 0x00, 0x00, 0x00, 0x00, Oxe6, Oxcc, Oxcc, 0x98, 0x98, Oxd8, 0x00, 0x00, 0x00}, 
is */ {0x00, 0x00, 0x00, 0x00, 0x00, 0x33, 0x66, Ox66, Oxcc, Oxf8, 0x60, 0x00, 0x00, 0x00}, 
is */ {0x00, 0x00, 0x00, 0x00, 0x00, 0x63, 0x46, Oxd6, Oxac, Oxfc, Oxb0, 0x00, 0x00, 0x00}, 
is */ {0x00, 0x00, 0x00, 0x00, Ox00, Ox63, Ox6c, 0x38, 0x70, Oxd8, 0x98, 0x00, 0x00, 0x00}, 
is */ {0x00, 0x00, 0x00, 0x00, 0x00, 0x63, 0x66, Oxc6, Ox8c, Oxfc, 0x18, 0x30, Oxe0, 0x00}, 
is */ {0x00, 0x00, 0x00, 0x00, Ox00, Ox7f, Ox4c, 0x18, 0x60, Oxcc, Oxf8, 0x00, 0x00, 0x00}, 
is */ {0x00, 0x00, 0x03, 0x06, Ox0c, 0x0c, 0x70, 0x18, 0x30, 0x30, 0x38, 0x00, 0x00, 0x00}, 
/* Font character 124 (ASCII value is */ {0x00, 0x00, 0x06, 0x06, Ox0c, Ox0c, Ox00, 0x18, 0x30, 0x30, 0x60, 0x00, 0x00, 0x00}, 
/* Font character 125 (ASCII value is */ {0x00, 0x00, Oxlc, 0x06, Ox0c, 0x0c, OxOe, 0x18, 0x30, 0x30, Oxc0, 0x01, 0x00, 0x00}, 
/* Font character 126 (ASCII value ) is */ {0x00, 0x00, Oxi1d, Oxf7, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00}, 
/* Font character 127 (ASCII value ) is */ {0x00, 0x00, 0x00, 0x00, 0x10, 0x38, Ox6c, Oxc6, Oxc6, Oxfe, 0x00, 0x00, 0x00, 0x00} 
} > /* End of italic array */ 





End Listing One 


e e 

Listing Two 
/* Copyright (C) Magna Carta Software, 1987. All Rights Reserved. x / 
/* MAKEFONT -- Makes an italic font for the EGA. at 
/* Note: Do not run this program from within the IDE. ay 
/* First version 10/29/87. Last update: 10/31/87. */ 


#ifndef SMALL 


#error Should use SMALL compilation model 
#endif 


#include <stdio.h> 
#include <dos.h> 
#include <process.h> 
#include <mem.h> 
#include <stdlib.h> 


#define TRUE 1 
#define FALSE 0 





/* Functions related to video operations */ 

void load_user_egaxfont (char *fptr,int block,int bpc,int char_count,int spos); 
void get_egafont(char *fptr, int font); 

int get_video info(void); 


/* Global variables and #DEFINES related to video operations */ 
#include "mk ital.asc" /* ITALIC.ASC contains our italic font */ 


Query+ MANAGER= 
Q-MAN 











MICROSOFT, TURBO AND MIX POWER C PROGRAMMERS. .. 
C WINDOWS TOOLKIT PUTS YOU IN CHARGE OF VIDEO! 


C Windows Toolkit is the only C programmer’s windowing package 
that comes with a complete tutorial on monochrome, Hercules, 
CGA and EGA video. We don't just provide the functions, we also 
explain how to use them reliably. 

And C Windows Toolkit comes with full, commented source code 
(would you trust a package that didn’t?). 










Q-MAN, a fast true relational data base management WINDOWING EGA/VGA SUPPORT 
system which supports interactive and imbedded FUNCTIONS = Use EGA 43sine mode 





e Create pop-up windows 

° os pull-down menus 

e Create spreadsheet menus 
° Create context-sensitive help screens i ri ines 
¢ Store windows for recall later 


° Free memory used by windows FAST SCREEN I/O 


¢ Use 8 different types of exploding windows © Write to the screen lightning fest 


SYSTEM SUPPORT * Write formatted output (like printf( ) ) 






¢ Use 2 fonts simultaneously 
* Design custom fonts 


queries, library routines, forms, and will be multi-user 
or distributed. Uses QUEL and SQL languages, B+ 
trees, and sort-merge joins. Free multi-user upgrade 
when released first quarter of 1988. 











































H ; ° : 
Runs on: single-user * Detect how many video adaptors are present a Se A on the CGA 
¢ Detect the types of video adaptor installed ° Read characters off the screen 
SYS 5 $1 395 ° Switch between adaptors 
© Detect 
4 2 | 395 ¢ Control the size and position of the cursor HERCULES SUPPORT 
: ¢ Detect the Enhanced Keyboard * Detect the presence of a Hercules Card 
™ ¢ Disable the video signal ¢ Detect Ramfont support 
MS-DOS 329 ¢ Delay program execution to microsecond ¢ Load a Ramfont 
resolution * Switch between modes 






Over 80 functions that enhance your productivity. 
Full source code included — No run-time royalties 
Includes 200 page manual — 30-Day Money-Back Guarantee 






To order 
Call collect 


(608) 271-2171 


Breakpoint Computer Systems, Inc. 


6701 Seybold Road, Suite 204 
Madison, WI 53719 













Magna 
Carta 
SOFTWARE 






Requires: IBM PC, XT, AT, PS/2 or compatible that will run 
Microsoft C and/or Quick C 
Supports Microsoft C 4.0/5.0/Quick C, Borland Turbo C 1.0/1 os; 






Include machine name and operating system 






















Mix Power C 
when ordering. From: “pag Carta Software 
P.O. Box 475594 
Visa and Mastercard accepted. Garland, TX 75047-5594 — Only $99.95 
MS-DOS" is a registered trademark of Microsoft Corporation. (214) 226-6909 wae (Texas residents add 8% sales tax) 
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#define VIDEO 0x10 /* BIOS video interrupt */ 
char fontarray[3585]; /* buffer for font storage */ 
int our_idl = Oxfac, our_id2 = 0x1000; /* our ID words */ 


char ega_color; 


/* Functions related to TSR operations */ 

int already installed(void) ; 

int deinstall (void); 

void interrupt (*old_int10h) (void); 

void interrupt intl0h(unsigned bp, unsigned di, unsigned si, 
unsigned ds, unsigned es, unsigned dx, 
unsigned cx, unsigned bx, unsigned ax); 





/* Global variables related to TSR operations */ 
unsigned save bpl, save _bp2, old_ds, old psp; 
unsigned old env; 


/* Turbo C system variables (see text for explanation ) */ 
extern unsigned _ brklvl; 
extern unsigned _psp; 


/* Other functions */ 
void error(int errnum); 


main () 

{ 
int 44. 35. &s 
union REGS regs; 


get_video_info(); 
if (!ega_color) regs.x.ax = 0x7; /* set the video mode */ 
else regs.x.ax = 0x3; 
int86 (VIDEO, éregs, éregs) ; 
if (already installed()) { 
deinstall(); 
printf("\The Italic font is now no longer installed"); 





exit(0); 
} 
/* system checks out -- go ahead and put italic chars. in font */ 
get_egafont (fontarray,14); /* store the ROM font in fontarray */ 


for (i=14*32,j=0; i< 14*128;4++) { 
for (k=0;k<14;k++) fontarray[it+] = italic _arr[j] [k]; 
} 





load_user_egaxfont (fontarray,0,14,256,0); /* load our font */ 
old_ psp = _psp; /* save the resident program’s PSP */ 
old_env = peek(_psp, 0x2c); /* save the resident program’s ENV */ 
old_int10h = getvect (VIDEO); /* save the old vector */ 

setvect (VIDEO, int10h) ; /* install our INT10h handler */ 


/* terminate and stay resident. Program length is determined by */ 
/* subtracting the psp address (_psp) from _ brkval which is */ 


/* dynamically set to the address of the end of DS. This «f 
/* appears to be reliable in the TINY and SMALL models, but ee 
/* results are unknown for other models. */ 


keep(FALSE, DS + (__brklvl + 15)/16 - _psp); 


/* ALREADY INSTALLED: This routine scans through memory for our ID byte.*/ 
/* Returns: 0 if not found, 1 if found. */ 


int already installed() 
{ 


unsigned int next_seg; 


for(next_seg = _psp-1; next_seg > 0; next_seg--) { 
if (peek(next_seg, (unsigned) és&our_idl) == our_idl) { 
if (peek(next_seg, (unsigned) sour_id2) == our_id2) { 
old_ds = next_seg; 
return (1); 


} 
} 
return (0); 


/* DEINSTALL: Remove our TSR by reseting interrupt 0x10 and video mode. */ 
int deinstall() 
{ 

union REGS regs; 

struct SREGS sregs; 


/* initialize old interrupt vector */ 

old_int10h = MK FP(peek(old_ ds, (unsigned) &0ld_ int1l0h+2),peek(old_ ds, (unsigned) 
&old_intl0h)); 

setvect (VIDEO,old_int10h); /* reset the interrupt vector */ 


(continued on page 55) 








Dr. Dobb’s Journal, March 1988 











It’s Our Objective 
to Keep You Oriented 


OBIECT- ORIENTED 
AOftawwuns 





Editor: Dr. Richard Wiener 


Univ. of Colorado 
Assoc. Editor: Prof. David Thomas 


Carleton Univ. 


The Journal of Object-Oriented 
Programming (JOOP) covers current 
research, developments and applica- 
tions in the object-oriented program- 
ming (OOP) field. 

It features carefully chosen peer- 
reviewed research articles and quality 
tutorial papers dealing with OOP. 

Six times a year, you will receive 
well-researched articles on topics 
useful in your daily work such as: 


problem solving 

reusuable OOP components 
language developments 
software management 
applications on artificial 
intelligence 

program testing 

software maintenance 
unbiased product reviews 
up-to-the minute product news 


Boo Wooo 


JOOP maintains a prestigious inter- 
national editorial board from industry 
and academia such as: 

Adele Goldberg — 

Parc Place Systems (Small Talk) 

Brad Cox — 

PPI, (Objective C) 

Bjarne Stroustrup — 

AT&T Bell Labs (C++) 

Get original research that’s 


definitive, authoritative and appli- 


cable. Get objective coverage that’s 
enlightening, reliable and functional. 

JOOP is the single communication 
vehicle uniting all professionals 
working in the field. 


Order before May 1, 1988, 
and become a 
CHARTER SUBSCRIBER 
for only $39 and save $10 
off the regular individual rate. 


(outside the U.S. — add $24) 
1 YEAR (six issues) - NOW $39 


Order Toll Free: 1-800-345-8112 
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DEBUGGING SWAT TEAM — 


Order Eco-C88 Rel. 4.0 New Modeling Compiler , —— 
and get C-more at no extra charge! : Sie 





























Seek and Correct 


You already know that fast compilation does not mean fast program development. Backing ; 
up for bogus error messages and removing the bugs takes time. Eco-C88’s “Seek and Correct 


three - way error checking finds even the most elusive bugs, clearing the path for swift program 
development. 


Double Barrel Error Checking 


Eco-C88 nails cold and tells you about the error in plain 
English. And there's no avalanche of false error messages, either. Other 
compilers can generate up to four times the number of error messages 
actually present; they leave it up to you to guess which ones are 

real. You'll be more productive with Eco-C88 because there is no 
guess work. 


Eco-C88 provides ten levels of checking. You can 
select from almost no checking to the fussiest you’ve ever seen. 
Eco-C88's “picky flag” finds subtle errors that slip by 

other compilers. 





Eco-C88 also features: 


e All data types, plus ANSI Enhancements 

e Robust library, including many new ANSI 
functions 

e CED editor with online function help, split 
windows, compile-edit-link capability 

© New, expanded manual with sample pro- 
grams for the library functions 


C-more Source Code 
Debugger 


Finally, if a really nasty bug persists, 
put C-more, our source code debug- 
ger, to work. With C-more you can ra 
watch your program as it executes, ig en 
single-step it, set simple or conditional 
breakpoints, test complex expressions, 

use variables as indexes into other vari- 

ables, initialize and trace variables, examine 

CPU registers, display results with printf()- 

type options and much more. C-more can help 
you track down bugs in minutes rather than days. 


Sa 


The price for Eco-C88 is $99.95. And, for a 


limited time, we’ll give you our C-more debugger 
at no extra charge. 


Ecosoft Inc. 
6413 N. College Ave. 
Indianapolis, IN 46220 


(317) 255-6476 (Tech Info) 
(800) 952-0472 (Orders) > 
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ITALIC FONT IN C 
Listing Two (Listing continued, text begins on page 34.) 


if (!ega_color) regs.x.ax = 0x7; 
else regs.x.ax = 0x3; 
int86 (VIDEO, &éregs, &regs) ; 


/* reset the video mode */ 


/* Deallocate the memory used by the resident program */ 


old psp = peek(old ds, 
old_env = peek(old ds, 


regs.x.ax = 0x4900; 
sregs.es = old psp; 
intdosx (éregs, éregs, &sregs) ; 
if (regs.x.cflag) error(3); 





regs.x.ax = 0x4900; 
sregs.es = old env; 
intdosx (&regs, &regs, &sregs) ; 
if (regs.x.cflag) error(4); 
return (0); 


/* DOS function to free allocated memory */ 


/* DOS function to free allocated memory */ 


(unsigned) &0ld psp); 
(unsigned) &0ld_env); 


/* INT10: This function is the BIOS video interrupt handler. a / 








else { 





{ 





_AX = ax; 
_BX = bx; 


void interrupt intl0h(unsigned bp, unsigned di, unsigned si, 


unsigned ds, unsigned es, unsigned dx, 
unsigned cx, unsigned bx, unsigned ax) 


{ 


_CX = cx; 
DX = ax; 


/* execute the old video interrupt */ 
if (ax >> 8) 


/* it is not a video mode reset */ 


save bpl = _BP; 
_BP = bp; 
(*old_int10h) (); 
_BP = save _bpl; 
= Ax; 
bx = _BX; 
cx = CX; 
dx = Dx; 


ax 


_AX 
_BX 


x 
DX 


(*old_ 


ax 
bx 
cx 
dx 


/* 


= ax; 
= bx; 
= CX; 
= dx; 


_AX; 
_BX; 
_CX; 
_DX; 


/* AH == 0 for a video mode reset */ 


inti0h) (); 


reload our font destroyed by the mode reset */ 
load_user_egaxfont (fontarray,0,14,256,0); 


/* LOAD_USER_EGAXFONT -- Load a user-defined font and reset page length.*/ 
/* Parms: ptr. to user table, block to load, bytes-per-char, x / 
/* number of chars to store, starting position in font table. */ 
/* First version 7/13/87. 


Last update 10/31/87. ald 


unsigned byte block: 


byte block = (bpc << 8) | block; 


void load_user_egaxfont (char *fptr,int block,int bpc,int char_count,int spos) 


/* Can’t use intr() due to Turbo C v1.0 compiler bug. */ 
/* Note: we must do any assignments to segments prior to doing */ 
/* assignments to AX since AX is destroyed. */ 
_ES = _DS; 

_AX = 0x1100; /* call function 0x11 */ 

_BX = byte block; /* block to load */ 

_CX = char_count; /* number of characters to load */ 
_DX = spos; /* character offset into table */ 
save bp2 = _BP; /* save BP for stack addressing */ 
_BP = FP_OFF(fptr); /* load address of user font */ 


{ 








regs.r_ax = 0x1130; 
if (font == 8) regs.r_bx = 0x0300; 
else if (font == 14) regs.r_bx = 0x0200; 


geninterrupt (VIDEO) ; 
_BP = save bp2; 


/* 


struct REGPACK regs; 


restore BP -- or die... */ 


/* GET_EGAFONT: This routine grabs an EGA font from ROM and stores it */ 
/* in the global variable fontarray */ 
void get_egafont(char *fptr, int font) 


/* EGA BIOS call to return font */ 


(continued on next page) 
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The C 
r=: Store. 


EVERYTHING FOR 
THE C PROGRAMMER 


PL US FREE SHIPPING! 

FREE SOFTWARE! 
LATTICE C COMPILER Ver 3.2 $229 
The classic DOS development environment. 


MICROSOFT C COMPILER Ver. 5.0 $269 


us 
= 
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Innovative CodeView™ debugger, “make”, more. 
TURBO C COMPILER Ver. 1.0 $69 
Fast, full development environment bargain. 
INSTANT C INTERPRETER Ver. 3.0 $379 


Instant linking, execution and debugging! 
Directly link Microsoft, Lattice libraries. 


C-TERP C INTERPRETER Ver. 3.0 $229 
Virtual memory support, versions for all compilers. 


PC LINT Ver. 2.13 $99 
Shake out C bugs before compiling; neat! 


ESI RESIDENT C Ver. 1.0 $79 
ESI RESIDENT C (w/source) $149 
Create TSR programs, handle interrupts! 

PANEL PLUS Ver. 1.0 (w/source) $379 
Complete screen 1/O development, no royalty. 
WINDOWS FOR C Ver. 4.14 $149 
WINDOWS FOR DATA Ver. 2.06 $229 
Flexible, fast, high quality windowing system. 

ES! SCREENSTAR Ver. 1.01 $79 
ES! SCREENSTAR (w/source) $149 


Generates C code for windows, data I/O. 


GREENLEAF LIBRARIES: 
Functions Ver. 3.10 $129 
Communications Ver. 2.10 $129 
Data Windows Ver. 2.10 $159 
Data Windows/With Source $269 


Seasoned, reliable library leader of the pack. 
CTREE Ver. 4.1 $299 
RTREE Ver. 1.1 $229 
CTREE/RTREE Package $499 
One of the fastest B—trees, handles networks. 
BTRIEVE Ver. 4.1 $179 
XTRIEVE Ver. 3.02 $179 
XTRIEVE report option Ver. 3.02 $99 
Innovative performer, fault tolerant B—tree. 
dbVISTA with Source Ver. 2.21 $389 
dbQUERY with Source Ver. 1.0 $389 
Very fast portable B—tree, SQL query option. 
NORTON GUIDE C Ver. 1.0 $69 


NORTON GUIDE C/ASM Twin Pack Ver. 1.0 $110 
Online help and reference when you need it. 


THE BEST QUALITY C PRODUCTS 
AT THE BEST PRICES! 








ORDER TOLL FREE: 
(800) 356-0909 
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Ror IN NEW YORK CALL: _ 
(800) 341-1950, EXT. 889 


FREE! PC-Write V2.71 complete word 
processor or Spectacular Two Player, 
Real-Time SPACEWAR V1.71 with 


every order! 
- FREE! No charge for UPS Ground. 
No surcharge for VISA or Mastercard. 
24 hour 1200 Baud order line! (914) 241-9324. 
Customer/Technical Support (914) 666-8119. 
No APO, FPO or international orders. 
30 day money back guarantee on unused items 
with intact seals. 
Returns subject to 20% restocking fee. 
Call first for RMA Number. 
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SQL Compatible Query System adaptable to any 
operating environment. 


CQL Query System. A subset of the Structured 
English Query Language (SEQUEL, or SQL) 
developed by IBM. Linked files, stored views, 
and nested queries result in a complete query 
capability. File system interaction isolated in an 
interface module. Extensive documentation 
guides user development of interfaces to other 
record oriented file handlers. 


Portable Application Support System 


Portable Windowing System. Hardware 
independent windowing system with borders, 
attributes, horizontal and vertical scrolling. 
User can construct interface file for any 
hardware. Interfaces provided for PC/XT/AT 
(screen memory interface and BIOS only 
interface), MS-DOS generic (using ANSI.SYS), 
Xenix (both with and without using the curses 
interface), and C-library (no attributes). 


Screen 1/0, Report, and Form Generation 
Systems. Field level interface between 
application programs, the Query System, and 
the file system. Complete input/output 
formatting and control, automatic scrolling on 
screens and automatic pagination on forms, 
process intervention points. Seven field types: 
8-bit unsigned binary, 16 bit signed binary, 16 
bit unsigned binary, 32 bit signed binary, 
monetary (based on 32 bit binary), string, and 
date. 


Including Source Code 
$395.00 


File System interfaces include 
C-tree and BTRIEVE. 


HARDWARE AND FILE SYSTEM 
INDEPENDENT 


MACHINE 
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INDEPENDENT 


SOFTWARE 


CoRPORATION 


1415 NORTHGATE SQUARE #21D 


RESTON, VA 22090 
VISA/Master Charge accepted 


(703) 435-0413 


*C-tree is a trademark of FairCom 
IBM, SEQUEL, PC, XT, AT are trademarks of IBM Corp. 
MS-DOS and Xenix are trademarks of Microsoft Corp. 


CQL and the COL logo are trademarks of 
Kurtzberg Computer Systems. 








ITALIC FONT IN C 


intr (VIDEO, éregs) ; 


} 


int get_video info() 





{ 
union REGS regs; 
unsigned char e byte; 


regs.h.ah = 0x12; 
regs.h.bl = 0x10; 
int86(VIDEO, &regs, &regs); 

if (regs.h.bl == 0x10) error(1); 


/* EGA is present -- is it active? */ 


e_ byte = peekb(0,0x487); 
if (e_byte & 8) error(2); 


else ega_color = TRUE; 


return (1); 


/* ERROR: A simple error handler. 
void error(int errnum) 
{ 

switch (errnum) { 


break; 


break; 


break; 


break; 


default:break; 
} 
printf("\nProgram exiting.\n"); 
exit (Oxf); 





Moving? 
Mail entire ad to: 


DR. DOBB’S JOURNAL 
P.O. Box 3713 
Escondido, CA 92025 


New address 


Please allow 6-8 weeks 
for address change 
to take effect. City 


Listing Two (Listing continued, text begin on page 34.) 


movedata (regs.r_es,regs.r bp, DS, (unsigned) fptr,14*256); 


/* GET__VIDEO_INFO: A VGA or an EGA must be installed for this program */ 
/* to work. The monitor must be an Enahanced Color or Monochrome */ 
/* display and the correct adaptor must be active. «/ 


/* First check for the presence of an EGA */ 
/* EGA BIOS alternate select x / 
/* return EGA information. x/ 


/* EGA not found */ 


/* EGA info. byte */ 
/* EGA not active */ 


/* Does the present, active EGA drive a color or mono monitor? */ 
if (regs.h.bh) ega_color = FALSE; /* EGA drives a mono monitor */ 
/* EGA drives a color monitor */ 


/* See if EGA drives an Enhanced Color Display */ 
if (ega_color) if (!(regs.h.cl == 3 || regs.h.cl == 9)) error(1); 


be 


case 1: printf("\An EGA and Enhanced Color or Monochrome Display"); 
printf("\nmust be present to use this program."); 


case 2: printf("\Please make the EGA the active adapter"); 
printf("in order to run this program."); 


case 3: printf("\nError deallocating program memory."); 


case 4: printf("\nError deallocating program PSP."); 


/* Return code for DOS errorlevel */ 


End Listings 


Affix your 
present label 
here. 





Dr. Dobb’s Journal, March 1988 





~~ 


| 
| 
| 
| 








“How to protect your software 
by letting people copy it.’ 


By Dick Erett, President of Software Security 





Inventor and 
entrepreneur, 
Dick Erett, 
explains his 

- company’s 

: view on the 
protection of intellectual 


property. 
A even sophisticated 
software develop- 

ment companies and the 

trade press seem to be miss- 

ing or ignoring is this: 
Software protection must 
be understood to be a 
distinctively different 
concept from that com- 
monly referred to as 
copy protection. 


Fundamentally, software 
protection involves devising 
a method that prevents 
unauthorized use of a 
program, without restricting 
a legitimate user from 
making any number of 
additional copies or prevent- 
ing program operation via 
hard disk or LANs. 

Logic dictates that mag- 
netic media can no more 
protect itself from misuse 
than a padlock can lock itself. 

Software protection must 
reside outside the actual 
storage media. The technique 
can then be made as tamper 
proof as deemed necessary. 
If one is clever enough, 
patent law can be brought 
to bear on the method. 

Software protection is at 
a crossroads and the choices 
are clear. You can give 
product away to a segment 








crucial point that 





Hard Disk Installation : Simply copy program disk 
to hard disk using DOS Command - Copy A:*.* C: 







the program diskette as you wish. 


program files. 








Program Back-ups : You may make as many copies of 


Data Back-ups : Use normal back-up and restore 


commands, including backing up sub-directories containing 


Networks : This product may be 

orks. Follow the same installation 
page 102 of this manual. The Block 

with the normal operation of any 





SAITIPPIOI? 






Soon all software installation procedures will be as straightforward as this. 
The only difference will be whether you include the option to steal your 


product or not. 


of the market, or take a 
stand against the theft of 
your intellectual property. 


‘.. giving your software 
away is fine...” 


We strongly believe that 
giving your software away 
is fine, if you make the 
decision to do so. However, 
if the public’s sense of ethics 
is determining company 
policy, then you are no 
longer in control. 

We have patented a device 
that protects your software 
while allowing unlimited 
archival copies and unin- 
hibited use of hard disks and 
LANs. The name of this 
product is The BLOCK™ 

The BLOCK is the only 
patented method we know 
of to protect your investment. 
It answers all the complaints 
of reasonable people con- 
cerning software protection. 


In reality, the only people 
who could object are those 
who would like the option 
of stealing your company’s 
product. 


‘eliminating the ratio- 
nale for copy-busting...”’ 


Since The BLOCK allows 
a user to make unlimited 
archival copies the rationale 
for copy-busting programs 
is eliminated. 

The BLOCK is fully pro- 
tected by federal patent law 
rather than the less effective 
copyright statutes. The law 
clearly prohibits the produc- 
tion of work-alike devices 
to replace The BLOCK. 


The BLOCK attaches to 
any communications port of 
virtually any microcomputer. 
It comes with a unique 
customer product number 
programmed into the circuit. 

The BLOCK 1s transpar- 
ent to any device attached to 
the port. Once it is in place 
users are essentially unaware 
of its presence. The BLOCK 
may be daisy-chained to 
provide security for more 
than one software package. 

Each software developer 
devises their own procedure 
for accessing The BLOCK 
to confirm a legitimate user. 
If it is not present, then the 
program can take appro- 
priate action. 


‘«',. possibilities... 
limited only by your 
imagination...” 


The elegance of The 
BLOCK lies in its simplicity. 
Once you understand the 
principle of The BLOCK, 
hundreds of possibilities will 
manifest themselves, limited 
only by your imagination. 

Your efforts, investments 
and intellectual property 
belong to you, and you have 
an obligation to protect 
them. Let us help you safe- 
guard what’s rightfully yours. 
Call today for our brochure, 
or a demo unit.” 









sf, 


O are 
loltuy Y inc. 


870 High Ridge Road Stamford. Connecticut 


06905 


203 329 8870 
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Listing One (Text begins on page 42.) 


/* 001 23-Apr-87 tbtree.h 
Header file for threaded binary tree functions. 
This code is hereby placed into the public domain. 
+/ 
/* define TREE_NODE type */ 


typedef struct tree ent { 


char *word; /* word ptr for this node */ 
int usage; /* usage counter for word */ 
int flags; /* word flags */ 


struct tree ent *lchild; /* thread or left child ptr */ 
struct tree ent *rchild; /* thread or right child ptr */ 
} TREE_NODE; 


/* define bit values for node flags */ 


#define RBIT (1) 
#define LBIT (2) 


/* right child if set, thread if 0 */ 
/* left child if set, thread if 0 */ 


End Listing One 


e e 
Listing Two 
/* 001 24-Apr-87 tbtree.c 
Functions to create and traverse a threaded binary tree. 
James Mathews 
Blue Sky Software 
172 Manor Drive 
Absecon, NJ 08201 
This code is hereby placed into the public domain. 


*/ 
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#include <stdio.h> 
#include "tbtree.h" 


#ifdef LINT_ARGS 
#include <malloc.h> 
TREE_NODE *talloc(); | 
void add2tree(char *); 
TREE NODE *linsert (TREE NODE *); 
TREE_NODE *rinsert (TREE NODE *); 
TREE_NODE *inorder_succ(TREE_NODE *); 
TREE_NODE *inorder_pred(TREE NODE *); 
#else 


/* setup for Microsoft C V 4.0 */ 


char *malloc(); 

void add2tree(); 

TREE_NODE *talloc(), *linsert(), *rinsert(); 
TREE | NODE *inorder _Succ(), *indorder pred(); 
#endif 


/* define the root node for the threaded tree */ 


TREE_NODE root = { "|", 0, RBIT, &root, &root }e 


[IR II IK TTT TTR TOK TOK TORTI TTI TOK KTH III RNA RA NA RH 


A.D D-2 TR EE 


RRERRERERRERRRREKERKERKERREEE EER ERRRRRRRERERERRERERRRRR ERE / 


void 

add2tree (word) 

char *word; 

{ 
register int cmp; 
register TREE NODE *tp = éroot; 


/* add given word to the B-tree */ 


/* search tree to find word, add it if not there lf 
while ((cmp = stricmp(word,tp->word)) != 0) { 
if (cmp < 0) /* not equal, look to the left? */ 


if (tp->flags & LBIT) /* is there a left child? */ 
tp = tp->lchild; /* yes, go look at it */ 

















(continued on page 60) | 
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T _ Custom 386 





Programmer's 
Workstation 





‘The winner, though, was the 
CAE/SAR 386. Its ESDI hard 
disk interface made it the 
fastest of all the machines in 





the disk access test." 


PC Magazine 
Dec. 22, 1987 





Looking for a lightning- 
quick 386 system that's 
tailored to your needs? 
CAE/SAR Systems, Inc. will 
Custom-fit you a 386 
system more powerful 
than most on the market. 
Whether it's a system 
designed for your program 
development, artificial 
intelligence, CAE, or 
systems design work, CAE/ 
SAR delivers reliable, 
powerful 386 workstations 
built for today's program- 
mers. 
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Based on a proven 386 
motherboard, CAE/SAR 386 
systems Come in dozens of 
different configurations for 
memory, disks, floating 
point and graphics. You 
can select high speed 
Crives (16 ms), ZOMb, 
140Mb, or 300Mb; EGA or 
mono monitors and cards; 
and 2.5Mb, 4.5Mb, or 8.5Mb 
32-bit RAM— plus other 
options! 

The CAE/SAR 386 systems 
run Unix and DOS concur- 
rently, and also run OS/2 


and Xenix. Floating point 
options are available for the 
Intel 387 chip. 


Basic Unix/Xenix 
systems start at $3,495. 


Get a system that fits you 
perfectly. Call CAE/SAR 
systems today for more 
information. 


CAE/SAR Systems, Inc. 
P.O. Box 50243 


Palo Alto, CA 94303 
(415) 949-3816 


CIRCLE NO. 132 ON READER SERVICE CARD 


Dr. Dobb's Journal, March 1988 









EO 


| 








BINVOICE 


Invoice No.: p 


Search for customer record? (Y/N): 
Enter customer information? (Y/N): 
Enter billing address? (Y/N): 
Enter marketing information? (Y/N): 


No. PRODUCT DESCRIPTION 


lr you program in C, take a few 
moments to learn how Windows for 
Data can help you build a state-of-the- 
art user interface. 


W Create and manage menus, data-entry forms, context- 


sensitive help, and text displays — all within windows. 


Develop window-based OS/2 programs right now, 


without the headaches of learning OS/2Z screen manage- 
ment. Run the same source code in PCDOS and OS/2 
protected mode. 


@ Build a better front end for any DBMS that has a C- 


language interface (most popular ones do). 


FROM END TO BEGINNING 


Windows for Data begins 
where other screen packages end, 
with special features like nested 
pop-up forms and menus, field en- 
try from lists of choices, scrollable 
regions for the entry of variable 
numbers of line items, and an ex- 
clusive built-in debugging system. 


NO WALLS 

If you've been frustrated by the limitations of other 
screen utilities, don’t be discouraged. You won't run into 
walls with Windows for Data. Our customers repeated- 
ly tell us how they've used our system in ways we never 
imagined — but which we anticipated by designing Win- 
dows for Data for unprecedented adapatability. You will 
be amazed at what you can do with Windows for Data. 


a 







Time: 
LustLoser—_—_—____—__—__— 
William Jones 
Innovative Software 
351 Bulletin Avenue 
Needham, MA 82194 
(617) 394-5512 


QUANTITY PRICE AMOUNT 


Subtotal: 
Shipping: 


TOTAL 
Payment : 


YOU ARE ALWAYS IN CHARGE 

Control functions that you write and attach to fields 
and/or keys can read, compare, validate, and change the 
data values in all fields of the form. Upon entry or exit 
from any field, control functions can call up subsidiary 
forms and menus, change the active field, exit or abort 
the form, perform almost any task you can imagine. 


OUR WINDOWS 
WILL OPEN DOORS 

Our windows will open doors to 
new markets for your software. 
High-performance, source-code- 
compatible versions of Windows 
for Data are now available for 
PCDOS, OS/2, XENIX, 
Se UNIX, and VMS. PCDOS 
versions are fully compatible with Microsoft Windows. 
No royalties. 





MONEY BACK GUARANTEE 

You owe it to yourself and your programs to try 
Windows for Data. If not satisfied, you can return it for 
a full refund. 

Prices: PCDOS $295, Source $295. OS/2 $495. 
XENIX $795. UNIX, VMS, please call. 


Call: (802) 848-7731 ext. 31 
Telex: 510-601-4160 VCSOFT FAX 802-848-3502 
om» Vermont 21 Elm Ave. 


fe 


an SOAS />.\ vn i 4 
ag Creative 


ws Software 


Richford, 
VT 05476 
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Listing Two (Listing continued, text begins on page 42.) 











else { tp->rchild = new; /* new is rchild of tp x] 
tp = linsert(tp); /* no left child, make one */ tp->flags |= RBIT; /* real node, not thread */ 
break; } 


} 
return (new); 


else /* not left, look right */ } 


if (tp->flags & RBIT) /* is there a right child? */ 





tp ti tp->rchild; /* yes look it over x / [RRR IR III ITI KTR TI TOKIO IT TTR TOTTI IORI TOKIO TOR IOI A KK 
, 
else { Gi NS. RT 
tp rinsert (tp) /* no right child make one */ FOCI CITOCCICOTIIOCIIOUOCIOTOI TTR III RII / 
= Py ’ 
break; : 
} Static TREE NODE * 
} linsert (tp) /* insert new node as left child of tp */ 
register TREE NODE *tp; 
if (cmp == 0) /* did we find the word? x/ { L “ 
tp->usage++; /* if so bump usage count */ register TREE NODE *new; 
fel ece 1 /* must have added new word */ if (new = talloc()) { /* alloc new entry */ 
tp->word = word; /* point it to the word */ new->lchild = tp->lchild; /* new gets what tp had */ 
tp->usage = 1; /*® new word in. town */ new->flags = tp->flags & LBIT; /* as a left child */ 
, } new->rchild = tp; /* rchild is thread to tp */ 
tp->lchild = new; /* new is lchild of tp * / 
[RRR KIKI KKK KKK KI KK IK KKK KKK KKK KKEARIEN NAH RK KK tp->flags |= LBIT; /* real node, not thread */ 
RINSERT } 


FOCI IK / return (new) . 
, 


} 
static TREE NODE * 


rinsert (tp) /* insert new node as right child of tp */ 
register TREE NODE *UpF hibit iteb thE EE ELELELELTLLLE LLL T reer eee eee eee 
{ ee te O-€ 
register TREE NODE *new; TOOT RR IK RIK RAIA / 
if (new = talloc()) { /* alloc new entry */ static TREE NODE * 
talloc() { /* allocate a TREE NODE */ 
new->rchild = tp->rchild; /* new gets what tp had */ 
new->flags = tp->flags & RBIT; /* as a right child */ #define NODES PER ALLOC (50) 
new->lchild = tp; /* lchild is thread to tp */ 








(continued on page 63) 











8031 
FORTH DEVELOPMENT ENVIRONMENT 








7 EQUATIONS Take advantage of Bryte’s tools to make your job easier: 
™ A® = lim $7 f (cx) Ax 
ROFF™ now supports the HP ee Fb e Bryte’s development environment uses BRYTE-FORTH 
LaserJet, Imagen, Laserwriter, and ax2 axdy on the actual production hardware during product 
all PosTScripT® printers! Peer erry development. No emulators, no changes, no surprises. 
2a 






Optional PC-based cross-development tools use DOS 
files as microcontroller mass storage. These files 
can be used to generate compact EPROM images, de- 

tailed listings, and cross-references. 





CRT screen OlTTar-yala¥elarercye! ereTs 


previewers for OMENS 

KoletelaMelesyadiare inclusion of 

are now included graphics directly 

with EROFF.” TOM VOLU 
documents. 


Full Creyees EWETIEL es on 
previewers for MS-DOS and 36 


SUN and different UNIX 


X-Windows are Systems. 
also available. 


Why not start developing the Bryte way today? 


Population (in Millions) of 15 States 


DIAGRAMS 





BRYTE-FORTH 8831 EPROM 100.00 
(includes 130 page User’s Manual) 

Utility disk(s) 65.00* 

Cross-compiler/Cross-assembler 235.00 

8031 unlimitted quan. license 1000.00 





Includes complete source code 













Percent by Weight : 
Carbo 

Protein | Fat hydrate | 

5 13.0 | 


















oryte computers, inc. 


P.O. Box 46 
Augusta, ME 04330-0046 








Elan Computer Group, Inc. 
410 Cambridge Ave., Suite A, Palo Alto, CA 94306 
Moreen = 415.322.2450 






207/547-3218 
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LabVIEW 


sUitonreCorsisce 
and Engineering 
Software System 









Special Issue. 
Special Advertising 
Opportunity. 


Until now there simply hasn't been a single reference 
source for Macintosh software developers. 


Dr. Dobb's Journal changes the picture... 
with one information-packed special issue: 
Dr. Dobb's Macintosh Special. 


4 
Dr. Dobb's Macintosh Special has more than 


100 pages of essential information that 
Mac programmers will turn to time and time again. 


€ 
If you've got a product for the Macintosh 


software pro, Dr. Dobb's Macintosh Special 
offers a unique advertising opportunity. 


: | Dr. Dobb's Macintosh Special provides detailed 
a information exclusively for the Macintosh software 
developer, with features like ... 


= : = The Macintosh programming environment. How software 
professionals will maintain the momentum of 1987. 












: = The Mac II. Why the Mac II is the programmer's machine 
Lo of choice in 1988. 


= HyperCard. An in-depth technical examination... 
plus source code and product guides. 


4 


Dr. Dobb's Macintosh Special is a tool that will be 
saved and referred to over and over. It will be 
strategically placed next to thousands of professional 
developers’ Macs...and your marketing message will 
produce sales for months. 


“INV sae 






Rett 
Sen) Sonn 
a8) anne 
GME eee & 
NATIONAL __ 
dadeorttairnatounnnas 
Di hs ae wk cst lee was a te 
~The Leader in THEE-488 | 
TT dios relimbiod ba [| 
fin eng are g204 
“€ALLEOR ARaE CAEALOG — 
B00/531-4742512/250-9119, 
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For our cost-effective advertising rates, call today. 
Think about the opportunity Dr. Dobb's Macintosh 
Special represents..but don't think too long. 
Space is limited. 









Ferris Ferdon 
Director of Advertising 
(415) 366-3600 


4 
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THE BEST OF BOTH WORLDS 


Developing an application used to be easy — all you 
had to do was program it. But today, with countless lan- 
guages, compilers, libraries, databases, editors, debuggers, 
and other tools, it is choosing the right development soft- 
ware that creates the real problem. 

Now The Andsor Collection introduces a unique solu- 
tion: a collection of sophisticated development tools, which 
you can use on their own, or together with your old ones. 

The Andsor Collection is, of course, the superb 
application development system that programmers, VARs, 
and other developers have been using for over two years. 
And starting with Version 2.2, The Andsor Collection has 
acquired a new dimension: now you can access all its func- 
tions from within another program! 

Think of it as a comprehensive, universal, language 
independent library. But The . 

Andsor Collection is not a 
collection of subroutines: it is 
a seamless, integrated, inter- 
active environment, specif- 
ically designed to expedite 
application development. 

Whether you use C, 
Pascal, Cobol, Fortran, Basic, 
or any other language, The 
Andsor Collection can en- 
hance your applications dra- 
matically. Whether you add 
functions to an old program, 
or you write a new one, you 
can make them faster, more 
efficient, and more appealing. 

Use The Andsor Collec- 
tion to implement an entire 
application, or just portions of 
an application. You can, for 
example, create a windowed 
environment, add attractive 
data entry functions, define 
indexed data file structures, 
produce sophisticated reports 
or forms, and so on. 











Although The Andsor Collection has far more features 
than other development systems, it is only one tenth their 
size. So the entire system can stay in memory, keeping all 
functions instantly accessible. 

And The Andsor Collection is famous for its unique 
interactive environment. There is no conversion or transla- 
tion — modify a procedure, a file definition or relation, a 
data entry screen, or anything else, and the change takes 
effect immediately, even while the application is running! 
Application development is a new experience. 

The application users will benefit too. The Andsor 
Collection is amazingly fast, and since all data is in vari- 
able length format, the files take a fraction of the space 
needed with other systems. So not only will you develop 
your applications sooner, but they will be more efficient 
too. Whether you use The An- 
dsor Collection alone, or to 
enhance a program. 

So get the best of both 
worlds. Order The Andsor 
Collection today, and discover 
a whole new environment, 
without giving up your old 
development tools or your ex- 
isting applications. Moreover, 
The Andsor Collection will be 
useful with all your future ap- 
plications and languages. 

You won’t find a better 
value in development soft- 
ware: one program that is 
both a powerful stand-alone 
application development sys- 
tem, and a unique language 
independent collection of soft- 
ware tools; plus the run-time 
interpreter with unlimited 
royalty-free distribution. All 
for an incredibly low price. — 
And with our 60 day money 
back guarantee*, you have lit- 
tle to lose and a lot to gain. 





“We looked at several systems and de- 
cided to standardize on The Andsor Col- 
lection. We are using it in many applica- 
tions in several departments.” 


Gordon Eyers, Director of In- 
formation Services, Public Utilities 
Commission, Brantford, Ontario 


“With The Andsor Collection we have 
achieved faster development and more 
efficient applications, which is important 
in large and complex projects like our 
Court Management System.” 


Dr. Mark Schrager, Consultant, 
Municipal Computer Services, 


“The Andsor Collection is unequalled 
when we need a solution in a hurry. Ap- 
plications that we have implemented in- 
clude modeling, data acquisition and 
analysis, and reporting.” 


Joe Blask, Engineering Support, 
General Motors, Troy, Michigan 


Rochester, New York 


ANDSOR: 


ANDSOR RESEARCH INC. 
390 Bay Street, Suite 2000 
Toronto, Ontario M5H 2Y2 
(416) 245-8073 


“Price includes shipping in the U.S. and Canada. Please add $10 for shipping 
to other countries. If you return the software, $8 will be deducted from the re- 


fund, to cover our shipping cost. 


System requirements: any IBM PC or PS/2 or fully compatible, 250K + (excluding DOS and other 
programs), one disk drive or hard disk, monochrome or color monitor, DOS 2.0+ or 0S/2 


© 1988 Andsor Research Inc. Andsor is a registered trademark and The Andsor Collection is a trademark of Andsor Research Inc. 


IBM is a registered trademark and IBM PC, PS/2, OS/2 are trademarks of IBM Corporation 








“a5... 
(includes shipping*) 


Visa, MC, AmEx, Check 


To order call toll free 
(U.S. and Canada) 


1-800-628-2828 


Ext. 535 
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Listing Two (Listing continued, text begins on page 42.) 


static TREE NODE *tp; 
static int tidx = NODES PER_ALLOC; 


/* this routine allocates space for TREE_NODE nodes. It 
exists to cut down on the number of calls to malloc(). */ 


if (tidx < NODES PER_ALLOC) /* free nodes from last alloc? */ 
return (étp[tidxt+]); {* yes, return the next one */ 


/* allocate another block of TREE_NODE nodes */ 


tp = (TREE_NODE *) malloc(sizeof(TREE_NODE) * NODES PER_ALLOC); 


return (next); /* return successor */ 


[RREKKRREREREREEREKERERERERRREREERKEEEEEEEKEREREREKEKREKEREEE 


INORDER_PRED 


HK KIRK KKK KKK IKK KKK KKK KKK KK KEK EKER EERE RKKEKKK KK KK KKK KK / 


TREE NODE * 
inorder _pred(tp) /* return in-order predecessor of tp */ 
register TREE NODE *tp; 


CarEmaiaE es ac: 


tt 


{ 





if (tp == NULL) { register TREE_NODE *prev; 
printf("\nOut of memory in talloc()\n"); ‘ 
exit (); /* if the left child is a thread, it’s the predecessor */ 


} 
prev = tp->lchild; 





tidx = 1; /* return # 1 next time */ 
return (tp); /* return # 0 this time */ /* but if the left child is a real node, the predecessor is 
} right-most child of the left child */ 
if (tp->flags & LBIT) /*. real left.:child? —*/ 
GIO IIGIGITIIITIICITIII ICICI OI III III while (prev->flags & RBIT) /* find right-most */ 
INORDER succ prev = prev->rchild; /* child of that «/ 
SO RRO IIIT ORO TO TOR TOR TO TOI TOK TA TOK KICK / 
return (prev); /* return predecessor */ 
TREE_NODE * } 
inorder_succ(tp) /* return in-order successor of tp */ 


register TREE_NODE *tp; 


{ 


egister TREE NODE *next; en ce 
reg me End Listings 


/* if the right child is a thread, it’s the successor node */ 


next = tp->rchild; 





/* put if the right child is a real node, the successor is 
left-most child of the right child */ 


if (tp->flags & RBIT) /* real right child? */ 
while (next->flags & LBIT) /* find left-most */ 


next = next->lchild; /* child of that x / 


Jow You Have A Cuolce 


pate in Software Protection 
The Secom Key So ee eee age ae 



































CHOICE #2 


The Memory Key 


The Memory Key offers special 
flexibility. It comes with unique software 
which permits the use of its available 
read/write memory. Each byte of 
memory can be addressed individually 
or in groups.for specific identification. 
Also, numerical information can be 
transferred between the Memory Key 
and your software and acted upon. The 
Memory Key comes with special error 
checking abilities providing 100% 
reliability. Example applications are: 
[J modular package control 

} serialization 

software customization 

demo control 


auditable and easy 
software leasing 
J any “counter” operation 







The Secom Key provides effective 
software protection while insuring 
customer satisfaction. It eliminates the 
problems normally associated with 
copy protection. The Secom Key is 
designed for software packages 
which are reproduced identically. 
Available in quantities, for as low 
as $21.95. 


Both the Secom Key 
AND The Memory Key: 


j} are completely transparent 
to end user 


will not interfere with 
peripheral operations 


don't occupy disk drives 

allow unlimited backup copies 
are easily installed 

are very small in size 

















OOo 


OOo vu 


Secom offers alternatives! 


The ease of use, cost effectiveness and 


If you would like a demonstration functionality of the Memory Key allows 
ao Secom General Corporation package or additional information, for previously unavailable controls and 
4829 E. Franklin Street #500 please write or call: applications. 


Chapel Hill, North Carolina 27514 


(949) 942-8500 4-800-843-0413 
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TO THE MACS 








VTEK™ 


DEC® VT100/VT52 
and Tektronix® 
4010, 4014, & 4105 
Terminal Emulator 


Graphil 
Publication 
quality graphics 
on your IBM® PC 


Freenel integrete 





Listing One (Text begins on page 90.) 






/* resource decompilation of custom controls PROJ.Rsre */ 
/* decompilation performed by Alan Dahlbom's ResTools 2.01 */ 
/* PICTs, ICONs, ICN#s, and CDEFs not included */ 






resource ‘'BNDL' (128) agerioae 9 "CNTL' (9) 
{ 











ee eee *20 user-defined keys -ceeae 0, hol ituganad 
elarge scroll back buffer 'FREF', {0, 128}; visible, 
ehardware 132 columns "ICN#', {0, 128} % 
«Kermit and XMODEM mane 648, 
‘up to 800x600 screen OxSa, 
resolution on EGAs esha tak "CNTL' (1) 






}3 


*Z0Oom, pan, window plots (0, 0, 28, 130}, 





resource '‘'CNTL' (10) 








*“hot key” to DOS 















































‘linear, log, polar plots call VT100 keys, long and oe {0, 0, 66, 80}, 
bar charts, Smith charts | short breaks | 0, oe 
*3D curves, 3D surfaces *ANSII extensions to ey 0, 
*6 curve types, 8 markers VT100 for multi-color text "Press Me To Quit" 0, 
‘thick lines, panel fills ‘scrolling VT100 window bi 0x650064, 
°15 fonts, font editor on graphics screen resource ‘'CNTL' (2) ys 
4096 x 3120 resolution -convert files to .GEM & ( bi 
‘zoom, pan, window plots | -PIC formats iy ee hagepe eae: resource 'CNTL' (11) 
shigh resolution printer & $150. Site and source visible, wt i Ba ay 56) 
plotter dumps in color code licenses availabls a SPL an we 
aS 643, visible, 
Over 150 C and assembler 8 EDIT ™ Ox140000, | . 
routines for full control = bi bse 
$395 with source code. Our new binary editor “ait he a ns 
For personal use only. for programmers - $29 (0, 0, 40, 40} 
, 0, resource 'CNTL' (12) 
MOST HARDWARE IS SUPPORTED pores ek eee 
Scientific Endeavors Corporation 52, | qiilite; 
Oxle, 0, 
Route 4,Box 79 Kingston, TN37763 (615) 376-4146 vane | 651, 
resource ‘CNTL' (4) ee bia 
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" : CRS — — — te = {0,'-0, 30, 178), 


}3 





{240, 300, 297, 361}, 
0 


>> 
44 


resource '‘CNTL' (14) 
{ 


| Ay resource '‘'CNTL' (13) 
visible, { 

14, {0, 0, 40, 38}, 
768, 0, 
641, visible, 
0x280000, 0, 

} “Evolve Or Dissolve" 0, 

3 652, 

0x82, 

resource 'CNTL' (5) "\0x00" 





| Ra, visible, 
Deen, YS 0, {240, 300, 277, 337}, 
| Now you can use QPARSER+ to develop com- 0, SEN 
| pilers, interpreters, complex user-interfaces, language 0x330032. 0, 
| & file format translators (i.e. Pascal to C, Bit Map Pah cand | 653, 
ito Postscript), language debuggers like lint, etc.. a add 0x8d008e, 


{ i; 


(:0,;.0,:°78,': 80}, 
| Develop language translators in C and Pascal visibia, 
| within the IBM PC/XT/AT or VAX/VMS environments. . 10, 0, 40, 40}, 


resource '‘'CNTL' (15) 


|}A new user manual, automated syntax tree con- 647, visible, 

| struction and an advanced code generation language ee 

|are just a few of the improvements over the original ie 0x96, 
QPARSER. . resource ‘CNTL' (7) | , "NOxbo" 








{0, 0, 50, 45}, 





MikiiSiee: 


Fa ’ resource '‘'CNTL' (16) 
af ir visible, { 
ns 0, {0O, 0, 40, 40}, 
: 0, ’ 
646, visible, 
0x46, 0, 
rte oe 
}? 655, 
Oxal00a0, 
resource 'CNTL' (8) "\0x00" 


{ }3 
{07-O,: 200, 116}; 
0 





’ resource '‘'CNTL' (17) 
visible, { 
! Another translation by QPARSER: | o Sale tesa) 
: Limited Time OSE — FREE demo disk available 0x50, | a, 
+ $300 };3 $4: a? 
ae CAD Systems i Oxab00aa, 











I 
j Q y 
1164 Hyde Avenue, San José CA 95129 (408) 727-6884 
— Quiside Calif, call TOLL-FREE (800) 538-9787, 
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}; 


resource 


{ 


}5 


“CNTL" (278) 


{0, <0,°36,. £201 ; 
3, 
visible, 
10, 

Q, 
640, 

0x0, 

"Turn Off Some Buttons" 








047.1330, 875 270}; 
Control {enabled, 15}; 
{148, 142, 188, 182}, 
Control {enabled, 16}; 
{22, 377, 209, 462}, 
Control {enabled, 17}; 
(49... 185°; 67, 2138), 
Control {enabled, 18}; 
{21 4;-° 305; 232,455}; 
Control {enabled, 19}; 
{101 <297; .125;. 322}, 
Control {enabled, 20}; 
{5;- 364,.-hi,-¢54}), 
Control {enabled, 21} 
} A 








resource '‘'CNTL' (19) ‘: 
{ ’ 
{0, 0, 18, 150}, resource 'DITL' (210) 
visible, { 
ries {10, 10, 178, 286}, 
642 Picture {enabled, 210} 
0x0, om. 
"Turn On Some Buttons" $ 
be | yesource 'DLOG' (1) 
' ' | { 
resis CNTL (20) {0, 0, 272, 462}, 
1, 
A O, 24, 24}, invisible, 
’ noGoAway, 
visible, 0x0, 
0, at 
645, 4 New Dialog 
0xc900c8, F 
': .. resource ‘'DLOG' (210) 
’ | { 
resource '‘'CNTL' (21) By Oy 2Re Rae 
{ died 
invisible, 
(0, Gy 42,. S01; noGoAway, 
SA 0x0, 
oe 210, 
0. "New Dialog" 
640, Mi 
Ox0, 'FREF' (128 
"\0xa91987 Stan Krute" oth ache ( ) 
}3 ‘APPL', 
userdefined resource 'CuCo' (0) 0, 
pstring: "custom controls demo Mi 
version 1.¢ ©1987 by Stan Krute resource 'MENU' (1) 
all rignts reserved" 
1, 
}3 0, 
Oxffffffff, 
resource '‘'DITL' (1) enabled, 
{ “custom controls demo", 
{238, 326, 266, 456}, { 
Control {enabled, 1}; } 
{7,. by. 43, -t33}- }: 
Control {enabled, 2}; ‘ 
{129, 285, 169, 325}, readurée STR * (20) 
Control {enabled, 3}; { 
{174, 197, 204, 35}; H "Peace Is War" 
Control {enabled, 4}; | }: 


{201, 120, 258, 181}, 
Control {enabled, 5}; 


‘SER 40 
{4, 230, 82, 310}, teas patie 
Control {enabled, 6}; "Grow Up Or Blow Up" 
{12, 169, 62, 214}, hs 


Control {enabled, 7}; 
{725 902 1271, "ki 6}, 
Control {enabled, 8}; 
(213, “299, 263, 287}, 
Control {enabled, 9}; 
{69,- 441; 135; 222}, 
Control {enabled, 10}; 
(5,> 320, -41, '356], 
Control {enabled, 11}; 
€138,. 226, 5 170;,;{288},, 
Control {enabled, 12}; 
(96,. 238,.130,: 276}, 
Control {enabled, 13); 
{10S,; 335, 142,,°:372}; 
Control {enabled, 14); 





End Listing One 


@ e 
Listing Two 
asm rectCDEF.asm Exec QUED/M 2.04 
link rectCDEF.link Exec QUED/M 2.04 
RMaker rectCDEF.RO Exec QUED/M 2.04 
RMaker rectCDEF.R1 Exec QUED/M 2.04 
RMaker rectCDEF.R2 custom controls demo QUED/M 2.04 


End Listing Two 
(Listing Three continued on next page.) 
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FORTRAN 
TO C 
a 


ORC 


Discover the power of C! 


Use FOR_C™ to convert standard FORTRAN-77 (with MIL-STD- 
1753 and common FORTRAN-77 extensions) into ANSI C with 
great speed and ease of use. 


¢99+% conversion ¢FOR_C™ generates 
rate on standard C-style prototypes 
FORTRAN-77 and checks your 

e Translate code FORTRAN source 
for consistent 
usage, allowing you 
to customize func- 
tion calls in C. This run-time libraries — 
results in the best now acomplete 

and most concise C_ solution to your 
code possible portability problems! 
Simply the best FORTRAN to C translator available — at any price! 


Order your copy today! 
Taltceye [fei Co) AVM @)ic:lemlobe@ haa icmavers 


AFTER MAY 1, 1988: $750.00 
=r-Yol €-1¢ (=m [acer [Ole (-s-M-ip @anlelal(al-Mmid-1-m-Je] e) elelaa-lalemel ele] ¢-lel-1- 


COBALT BLUE 


1683 Milroy * Ste 101 ® San Jose * CA 95124 
(408) 723-0474 





e Produces read- 
able, maintainable 
code with precise, 
and accurate 
translations 

e Includes C 
SOURCE to all 


between PC’s and 
mini-computers 

e Utilize a built-in, 
C-like preproces- 
sor for easy code 
customization 
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TURBO C QUICK C LET'S C DESMET C DATALIGHT C ECO-C 
LATTICE C MICROSOFT C AZTEC C COMPUTER INNOVATIONS C 


NEW --- Limited time offer. 


Peacock System's CBTREE 
Object library for only $49! 


Our FULL COMMERCIAL VERSION of CBTREE in object library format 
is being offered for the amazingly low price of $49. 


CBTREE provides you with easy to use functions that maintain key 
indexes on your data records. These indexes provide you with fast, 
keyed access, using the industry standard B+tree access method. 


Everything you need to fully utilize CBTREE in your applications is 
included. The CBTREE source code can be purchased later at any 
time for the $110 difference. Example source programs and utilities 
are included FREE. 


CBTREE source library $159 
Object library only $49 












This limited time offer is simply too good to refuse. Peacock's standard 
ROYALTY FREE, UNCONDITIONAL MONEY-BACK GUARANTEE, 
AND FREE TECHNICAL SUPPORT applies to this offer. 









To order or for additional information 
call 1-800-346-8038 or (703) 847-1743 or write: 





PEACOCK SYSTEMS, INC. 
2108 GALLOWS ROAD, SUITE C 
VIENNA, VA 22180 












PEACOCK SYSTEMS. INC 
Trademarks: Turbo C (Borland); Quick C (Microsoft); Let's C (Mark Williams); DeSmet C (DeSmet 

Software); Datalight (Datalight); Lattice C (Lattice); Microsoft C (Microsoft); Aztec C (Manx Software); 
Computer Innovations C (Computer Innovations); Eco-C (Ecosoft, Inc). 
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NROFF/PC™ 
The REAL Thing for DOS 
NROFF/PC is a complete 


text formatting system for 
MS-DOS systems. Including: 








NROFF The powerful UNIX 
text formatter 









TBL A tool to assist 
with the layout of 
tabular material in 

Nroff documents 








A comprehensive 
Nroff macro pack- 
age for preparing 
books and_ tech- 
nical manuals 








A tool for describ- 
ing mathematical 
equations in Nroff 
documents 








eAll tools are a complete port 
from the AT&T Documentor’s 
Workbench 2.0 











elt’s Fast! We've modified 
Nroff especially for DOS for 
lightning speed 





e Supports any Dot Matrix printer 
and many laser printers 


e Specially Priced At $99 










eA complete Troff typesetting 
system is available NOW for 
LaserJet and PostScript printers 
on MS-DOS for $695, XENIX 
and Microport UNIX for $795. 


——a 









A St RES 







Elan Computer Group, Inc. 

410 Cambridge Ave., Suite A 

Palo Alto, CA 94306 
(415) 322-2450 


Visa and MasterCard Accepted 


Unix is a tradmark of AT&T 
MS-DOS and Xenix are tradmarks of Microsoft 


CIRCLE NO. 143 ON READER SERVICE CARD 








66 








TO THE MACS — 


Listing Three (Text begins on page 90.) 


+ +e Fe eH eH eH He HF HF FH HH HH eH HH He He OH OH OH OO OH OHO 


* 


Se te Se Fe Me Se Se Be Be Se Se Be Be Se Be Be BE Be 


at i i eT ee? eT | 


Se Se Se Se Se 


Se Se Se Se Ne 


rectCDEF.Asm 


Assembly language source code for several styles of button controls 


file information 


The assembled code is meant to be a CDEF resource 


The CDEF provides 16 styles of rectangular button controls 

contain text, an ICON, or a PICT 

can be outlined, or shadow-outlined 

if it contains an ICON or a PICT, can be bare 
indicate pressing via inversion or a content change 


A button can: (1) 
(2) 
(3) 
(4) 


Edited with QUED/M 2.04 
Compiled under MDS 2.01 


Written and ©1987 by Stan Krute. All rights reserved. No part of this 
file, or the object code it leads to, may be reproduced, in any form or 
by any means, without the express written permission of the author and 


copyright holder. 


Timestamp: 6:51 pm PST 


This file looks good in 9 point Courier, QUED/M 2.04 tabs set to 3 


details on using the CDEF resource produced by this code 


using the CDEF 


November 16, 1987 
Spacestamp: 18617 Camp Creek Road Hornbrook, California 96044 





a custom control is most easily specified via a CNTL resource, 
which uses a procID to indicate the CDEF resource ID and variation code 


for this CDEF, the resource ID is 40 


there are 16 variations, as follows: 


variation content border 


0 text 
1 text 
2 text 
3 text 
4 PICT 
5 PICT 
6 PICT 
7 PICT 
8 PICT 
9 PICT 
10 ICON 
a E ICON 
12 ICON 
13 ICON 
14 ICON 
15 ICON 


outlined 
outlined 
shadowed 
shadowed 
bare 

bare 

outlined 
outlined 
shadowed 
shadowed 
bare 

bare 

outlined 
outlined 
shadowed 
shadowed 


highlighting via 


inversion 
content change 
inversion 
content change 
inversion 
content change 
inversion 
content change 
inversion 
content change 
inversion 
content change 
inversion 
content change 
inversion 
content change 


648 
649 
650 
651 
652 
653 
654 
655 


for TEXT variations, select a font via the CNTL's contrlValue field: 
-1 for the window's font, 0 for the System font, 1 for the application font, 
anything else a standard Mac font number 
in the case of a font other than the System or window's font, store the font 
style in the high byte of the contrlMin field, and the font size in the 


low byte of the contrlMax field 


for PICT and ICON variations, store a resource ID indicating the PICT or ICON 
resource in the low word of the CNTL's refCon field 


for variations that indicate highlighting via a content change, store a resource 


ID indicating the highlighted-state STR 


(for text variations), PICT, or 


ICON resource in the high word of the CNTL's refCon field 


when figuring the size of a text button's boundsRect : 


be sure to size the button so the text will fit. Successive approximation works 
well. Rule of thumb for an initial height: 8 greater than the font size. 


when figuring the size of a PICTure button's CNTL's boundsRect : 


if the picture has no outline, try a boundsRect that matches the PICT's boundsRect 
if the picture is outlined, try a boundsRect that's at least 4 wider and 4 
higher -- that size lets the picture perfectly match the button's interior 


pictures in larger boundsRects get centered 


when figuring the size of a ICON button's CNTL's boundsRect : 
if the icon has no outline, try a boundsRect that matches the ICON's boundsRect 
if the icon is outlined, try a boundsRect that's at least 4 wider and 4 

higher -- that size lets the icon perfectly match the button's interior 


icons in larger boundsRects get centered 











(continued on page 69) 
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d and power ote hardware-assisted | debusger ata 
software I shoes Rss = 


How Soft-ICE works 


Soft-ICE unleashes the power of the 80386 to surround your program in a 
virtual machine. This gives you complete control of the DOS environment. 
Soft-ICE uses 80386 protected mode features, such as paging, I /O privilege 
level, and break point registers, to add real-time hardware-level breakpoints to 
your existing DOS debugger. To use Soft-ICE you simply pop the Soft-ICE 
window up through a key sequence, set your hard break points, then return to 
your soft debu upger. As the target program is executing, Soft-ICE recognizes 
when the breakpoint conditions have been reached and gives control back to 
your soft debugger. And this is all done at full 80386 speed! Soft-ICE can 
also be used in stand-alone mode. This comes in handy if you are debugging 
loadable device drivers, interrupt handlers, or terminate and stay resident 
programs. All of the standard debugging features are available to help you 
find the most difficult systems problems. 





"Since © Soft- ICE doesn’t take up any of my peg! I have it in my AUTOEXEC.BAT to load every ae It has saved 
Ir 


me at least one month’s time on my latest device driver program." Peter Ricker, President of Maverick Software 

















y serine shtishaction giaranter. Visa and Master Cardia acce ted. As cab 
| To order ¢ or ‘to — more ems upsartits call es he . 






= = =~ 2 oe BOX 7607 _. 
_ 7 ave NASHUA, NH 03060-7607 
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“UNLEASH YOUR 80386! 





Your 80386-based PC should run two to 
three times as fast as your old AT. This 
speed-up is primarily due to the doubl- 
ing of the clock speed from 8 to 16 MHz. 
The new MicroWay products discussed 
below take advantage of the real power 
of your 80386, which is actually 4 to 16 
times that of the old AT! These new pro- 
ducts take advantage of the 32 bit regis- 
ters and data bus of the 80386 and the 
Weitek 1167 numeric coprocessor chip 
set. They include a family of MicroWay 


mW1167 Numeric 
Coprocessor Board 





MicroWay 80386 Compilers 


NDP Fortran-386 and NDP C-386 are globally 
optimizing 80386 native code compilers that 
support a number of Numeric Data Processors, 
including the 80287, 80387 and mW1 167. They 
generate mainframe quality optimized code and 
are syntactically and operationally compatible to 
the Berkeley 4.2 Unix f77 and PCC compilers. 
MS-DOS specific extensions have been added 
where necessary to make it easy to port pro- 
grams written with Microsoft C or Fortran and 
R/M Fortran. 

The compilers are presently available in two 
formats: Microport Unix 5.3 or MS-DOS as ex- 
tended by the Phar Lap Tools. MicroWay will port 
them to other 80386 operating systems such as 
OS/2 as the need arises and as 80386 versions 
become available. 

The key to addressing more than 640 kbytes 
is the use of 32-bit integers to address arrays. 
NDP Fortran-386 generates 32-bit code which 
executes 3 to 8 times faster than the current 
generation of 16-bit compilers. There are three 
elements each of which contributes a factor of 2 
to this speed increase: very efficient use of 
80386 registers to store 32-bit entities, the use of 
inline 32-bit arithmetic instead of library calls, 
and a doubling in the effective utilization of the 
system data bus. 

An example of the benefit of excellent codeisa 
32-bit matrix multiply. In this benchmark an NDP 
Fortran-386 program is run against the same 
program compiled with a 16-bit Fortran. Both 
programs were run on the same 80386 system. 
However, the 32-bit code ran 7.5 times faster 
than the 16-bit code, and 58.5 times faster than 
the 16-bit code executing on an IBM PC. 

NDP FORTRAN-386™ ............... $595 
PR sche ood we cack cat $595 





80386 compilers that run in protected 
mode and numeric coprocessor cards 
that utilize the Weitek technology. 

The benefits of our new technol- 
ogies include: 
e An increase in addressable memory 
from 640K to 4 gigabytes using MS- 
DOS or Unix. 
e A 12 fold increase in the speed of 32 bit 
integer arithmetic. 
¢ A 4 to 16 fold increase in floating point 


MicroWay Numerics 


The mW1167™ is a MicroWay designed high 
speed numeric coprocessor that works with the 
80386. It plugs into a 121 pin “Weitek” socket 
that is actually a super set of the 80387. This soc- 
Ket is available on a number of motherboards 
and accelerators including the AT&T 6386, 
Tandy 4000, Compaq 386/20, Hewlett Packard 
RS/20 and MicroWay Number Smasher 386. It 
combines the 64-bit Weitek 1163/64 floating 
point multiplier/adder with a Weitek/Intel de- 
signed “glue chip”. The mW1167™ runs at 3.6 
MegaWhetstones (compiled with NDP Fortran- 
386) which is a factor of 16 faster than an AT and 


2 to 4 times faster than an 80387. 
mW1167 16 MHz.................. $1495 
mW1167 20 MHz... oc. c. ee eecc eek $1995 


Monoputer™ - The INMOS T800-20 Trans- 
puter is a 32-bit computer on a chip that features 
a built-in floating point coprocessor. The T800 
can be used to build arbitrarily large parallel pro- 
cessing machines. The Monoputer comes with 
either the 20 MHz T800 or the T414 (a T800 
without the NDP) and includes 2 megabytes of 
processor memory. Transputer language sup- 
port from MicroWay includes Occam, C, Fortran, 
Pascal and Prolog. 

Monoputer T414-20 with 2 meg’ ...$1495 
Monoputer T800-20 with 2 meg’ ...$1995 


Quadputer™ can be purchased with 2, 3 or 4 
transputers each of which has 1 or 4 megabytes 
of memory. Quadputers can be cabled together 
to build arbitrarily fast parallel processing 
systems that are as fast or faster than today’s 
mainframes. A single T800 is as fast as an 
80386/mW1 167 combination! 

Biputer™ T800/T41 4 with 2 meg’... .$3495 
Quadputer 4 T414-20 with 4 meg’ ...$6000 
‘Includes Occam 


speed over the 80387/80287 numeric 
coprocessors. 

Equally important, whichever Micro- 
Way product you choose; you can be 
assured of the same excellent pre- and 
post-sales support that has made Micro- 
Way the world leader in PC numerics 
and high performance PC upgrades. 
For more information, please call the 
Technical Support Department at 

617-746-7341 
After July 1988 call 508-746-7341 


MicroWay* 
80386 Support 


80386 Multi-User Solutions 


AT8™ - This intelligent serial controller series is 
designed to handle 4 to 16 users in a Xenix or 
Unix environment with as little as 3% degrada- 
tion in speed. Ithas been tested and approved by 
Compag, Intel, NCR, Zenith, and the Department 
of Defense for use in high performance 80286 
and 80386 Xenix or Unix based multi-user 


systems. 

AT4 = 4 USCIS... cece cence cccuses $795 
PATE BAGS Bik oc ioe c ew Picneosin $995 
AT16 - 16 users .............00005: $1295 


Phar Lap™ created the first tools that make it 
possible to develop 80386 applications which 
run under MS-DOS yet take advantage of the full 
power of the 80386. These include an 80386 
monitor/loader that runs the 80386 in protected 
linear address mode, an assembler, linker and 
debugger. These tools are required for the MS- 
DOS version of the MicroWay NDP Compilers. 


Phar Lap FONG caisson cic cies ss $495 
PC/AT ACCELERATORS 

287Turbo-10 10 MHz................ $450 
287Turbo-12 12 MHz................ $550 
287TurboPius-12 12 MHz ........... $629 
FASTCACHE-286 9 MHz ............ $299 
FASTCACHE-286 12 MHz........... $399 
SUPERCACHE-286 ................. $499 
MATH COPROCESSORS 

80387-20 20 MHZ...........0ceceee $895 
80387-16 16 MHz..............0002- $495 
80287-10 10 MHZ. . 2. sac ecw ccecacs $349 
TE UNE oon cc wince uc vdceckass $259 
SOZET-CG We a ose ek co ee won $179 
Ce POE 6 aie Kid ea ba on pee vcdne $154 
OT OAS, ais wee oct ew ave cdemaaducece $99 


The World Leader in PC Numerics 

P.O. Box 79, Kingston, Mass. 02364 USA (61 7) 746-7341 
32 High St, Kingston-Upon-Thames, U.K., 01-541-5466 
St. Leonards, NSW, Australia 02-439-8400 
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Listing Three (Listing continued, text begins on page 90.) 
Fi ht EE A ON eT AT incjude. fi leg) qk ce see eee eS er hearer 43 


; standard Mac definitions 
Include MacTraps.D 
Include SysEqu.D 
Include ToolEqu.D 
Include QuickEqu.D 


condensed trap file 
system equates 
toolbox equates 
toolbox equates 


se Se Se Fe 


; our stuff 
Include rectCDEFEqu.Txt ; private definitions for this file 


sac aa satin apiemleneer meneame main ates lait ia a Coleen entry Poin -s<<<9 seers 68 ses eee * 
rectCDEFProc 
; provide a stack frame 


LINK A6, #-autoBytes 3; set frame pointer, with enough 
bytes for automatic variables 


-e 


; save some registers 
MOVEM.L D3-D7/A2-A4,- (SP) ; save some work registers 


3; the key to 68000 code : fill those registers 


LEA param(A6),A0 
MOVE.L (A0)+,D3 
MOVE.W (A0Q)+,D7 
MOVEA.L (A0)+,A2 
CLR.L D4 clear out D4 

MOVE.W (A0O)+,D4 ; varCode into D4 

MOVE.B varFlagTable(D4),D4; D4 holds a byte of variation flags 


AO points to param 

D3 holds param ( usage varies ) 

D7 holds message (operation selector } 

A2 holds theControl (control record handle ) 


. =e te Se Se fe 


: set a default function result of 0, while AO's pointing in the right direction 
CLR.L (AO) 


lock the control record down 
MOVEA.L A2,A0 
_HLock 


se 


3 get a pointer to the control record 
MOVE.L (A2),A2 


3 lock down and get a pointer to any control data block 
MOVE.L contrlData(A2),D0 ; grab the handle 


BEQ caseOut ; jump if NIL handle 
3 we've got a control data block, so lock it 

MOVEA.L DO,A3 ; copy the handle 

MOVEA.L A3,A0 7 lock the block 

_HLock 

MOVEA.L (A3),A3 3; get a pointer to the control data block 
caseOut 


3 case out on the message 
; just jump off a table of routine offsets 


ADD.W Die Di ; double the message integer 
MOVE.W messageTable(D7),D0; grab a table offset 
JSR messageTable (DO) 3; jump to messageTable + offset 


; clean up and go home 

3; if there was a control data block, unlock it 
MOVE.L contrlData(A2),DO0 ; grab the handle 
BEQ unlockRec ; jump if NIL handle 


3 we've got a control data block, so unlock it 


MOVEA.L DO,A0O z move the block's handle into place 
_HUnlock 3 and unlock it 
unlockRec 


3; unlock the control record 
MOVEA.L theControl (A6) ,A0 
_HUnlock 


; restore the saved registers 
MOVEM.L (SP)+,D3-D7/A2-A4 


3; remove the stack frame 
UNLK A6 


; fetch the return address 
MOVEA.L (SP)+, AO 


3; set stack pointer to the function result 
ADD.L #theResult-param, SP 


; we're outta here 
JMP (AQ) 


; there are nine possible messages 


(continued on next page) 
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How many 
@ programmers does 
it take to maintain a 
MAKE dependency file? 








NONE! /f you 
@ use VersiMAKE™ 


VersiMAKE™ is a full-featured 
MAKE utility that includes: 


@ Dependency Generation 
Derives your system’s dependencies, 
through analysis of its C and MASM 
source files. Say goodbye to manual 
maintenance of MAKE dependency files! 
@ Wild Card File Name Matching 
Analyzes an entire collection of source 
files with a single statement. 

@ Nested include File 


Handles standard C and MASM ‘‘include” 
conventions, and the INCLUDE environ- 
ment variable. 


@ Powerful Macro Facilities 
Built-in macros, user-defined macros, 
and environment variables. 


@ Analytical Reports 

Shows the entire Include file hierarchy 
for each source file analyzed, and all of 
the parent source files for each Include file. 


How many 
@ programmers does 
it take to trace a 
symbol thru your system? 





ONE! /f you 
@ use VersiCREF™ 





VersiCREF™ is a unique utility 
that creates a Master Cross- 
Reference of your entire system. 


@ Multi-Lingual 
Handles C, assembler, or both. 


@ Flexible 

File names with line numbers, or file 
names alone. Global and local symbols, 
or globals alone. 

B Powerful 


Easily handles systems containing 100 
source files or more. 


VersiMAKE™ $125 
VersiCREF™ $75 
Both $150 


(Outside U.S., add $5 for shipping 
and handling) 


Yf Uy 800-334-4096 


J7, Y (In NJ, 609-871-0202) 
MC/VISA/AMEX accepted 
SUMMIT INFORMATION 
SYSTEMS, INC. 
73 East Lane, Willingboro, NJ 08046 
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Only one language has the sleek design of 
C, the engineering features of Ada, and 
optimizing compilers that generate .OB]s 


bighly compatible with Microsoft C: Listing Three (Listing continued, text begins on page 90.) 
MODULA:2 == 
DC.W doDrawCntl-messageTable 7; draw the control 
DC.W doTestCntl-messageTable 7; test the control 
DC.W doCalcCCnt1l-messageTable ; calculate the control's region 
PMI is the principal sup lier of tools for DC.W doInitCntl-messageTable ; do control initialization chores 
Modula-2, 5 late DC.W doDispCntl-messageTable ; do control disposal chores 
*x* R ire®: A l- DC.W doPosCnt1l-messageTable 3; reposition & update the control 
ep ertotre®. ‘ nm enormous genera DC.W doThumbCnt1l-messageTable 7; calculate control dragging params 
pur pose toolkit. Includes hundreds of low- DC.W doDragCntl-messageTable ; drag the control 
level routines and 5 high-level subsystems: DC.W doAutoTrack-messageTable ; do the control's action proc 


(1) Industry's most powerful screen 


design/display System, supplements MS Rew ee en ew www ee the variations flag table SS * 
Windows; provides multi-line input fields, 
input validation, context sensitive help, ; there are sixteen control variations 
forms, etc. (2) Sophisti ist-ori 
DBMS: 7 ( ) e - agree list ely ; eight bits are used to flag eight qualities of a control variation 
> supports inary O jects, variabie- + from bit 7 (hi) to bit 0 (lo), the bits are symbolically named : 
length records, garbage collection, damaged : textBit - pictBit - iconBit - outBit - shadBit - bareBit - invBit - chngBit 
file recovery, etc. (3) Simple text editor; (4) 
: : : : varFlagTable 
Expression evaluators; (5) LISP like list DC.B %10010010 ; text - outlined - invert 
Manager. Includes full source 50 DC.B %10010001 ; text - outlined - content change 
(over 600K), and 300p manual. ... DC.B %10011010 ; text - shadowed - invert 
‘ j . DC.B %10011001 ; text - shadowed - content change 
* Repertotre®/ Btrieve® Toolkit: Novell/Soft- 
Craft's Btrieve file manager is the standard DC.B %01000110 ; pict - bare - invert 
for large business applications. R/BT is a DC.B = #01000101 ; pict - bare - content change 
. we . DC.B %01010010 ; pict - outlined - invert 
massiv stem 2 
. li .. ef Ade ; niet building Btrieve DC.B %01010001 7; pict - outlined - content change 
applications wit epertoires screen DC.B 01011010 ; pict - shadowed - invert 
system. Includes a customizable prototype DC.B %01011001 3; pict - shadowed - content change 
application. Ideal for consultants. Includes 5 ana 
Dc. 0 0 ; icon - bare - invert 
full R/BT osteoma ga and $] 49 DC.B %00100101 3 icon - bare - content change 
Repertoire object code. Sra sie,_€ fe. eisiers DC.B %00110010 7; icon - outlined - invert 
* EmsStorage™: Advanced, high-level DC.B %00110001 ; icon - outlined - content change 


DC.B 00111010 
memory manager that detects and uses LIM DC.B.—-$00111001 


Expanded Memory if present, or DOS 
memory if not. Provides automatic garbage 
collection and MS-Windows-like interface LOG eee ies uma gran es eet Ian i ee : 
(lock/ unlock functions) for porting $ 49 


icon - shadowed - invert 
icon - shadowed - content change 


=e fe 


; the application wants the CDEF to draw the control 





programs to MS Windows. ....... doDrawCnt1l 
J . ’ + aif control is invisible, do nothing 
* Macro2; Brings the full power of C’s macro TST.B contrlVis (A2) ; non-zero if the control is visible 
preprocessor to Modula-2; provides BEQ drawn ; it's invisible, so no need to draw it 
DEFINE, UNDEFINE, IFDEF, IFNDEF, 
INCLUDE, etc., for parameterized macro i Save ERM SHSEy Pen. Seats 
- aie : Z PEA entryPenState (A6) 
functions, conditional compilation, $80 ehitcamcany 
etc. Includes full source: .......... n 
4 Ls th tat 
* ModBase: A full B+ tree DBMS that uses a paar er ee 
file format compatible with Ashton-Tate’s > 
dBase III. Provides indexing and file + Save a copy of the entry clip region 
manipulation routines for use independent eae TASES + on SS eee 
kM _NewRgn 
of dBase; billions of records per 589 MOVE.L (SP),entryClipRgnCopy(A6); copy the entry clip region into it 
file. Includes full source........... _GetClip 
* Graphix: The Modula-2 interface to the ey ae 


widely used MetaWindow graphics library. 


7; see if a shadowed outline is to be drawn 








Supports multiple fonts, mouse tracking, BIST #shadBit,D4 ; check it out 
many printers (incl. Post-Script & BEQ simpOutTest ; no shadowed outline, on to the simple outline test 
LaserJet) over 30 display adapters. and BSR doShadOutline ; draw a shadowed outline 
; prey r A BSR shadOutIntClip ; set a clip rect for the interior 
hundreds of modes. Includes MetaWindow BRA interiorDrawing 7 on to the interior tests 
package. $ 
With source: eoeeeeeenteevreeneeseseee ] 89 simpOutTest 
$ ; see if a simple outline is to be drawn 
Object only? < s+ ices Pas ae | 49 BIST #outBit,D4 * check it out 
BEQ noOutNoTest ; if not, on to the no-outline duties 
Supported compilers: Logitech, BSR doSimpOutline + draw a simple outline 
. BSR simpOutIntClip 3; set a clip rect for the interior 
Se oe ee ee BRA interiorDrawing 7 on to the interior tests 
’ ’ ‘ 
exclusively from PMI; dealer noOutNoTest 
inquiries welcome. BSR noOutIntClip ; set a clip rect for the interior 
\ VISA/MC interiorDrawing 
textTest 
[ AMEX/COD/PO + see if the button will contain text 
49 BTST #textBit,D4 + text ? 
BEQ  pictTest 7 no, so next test 
(503) 777-8844 BSR doTextInterior 7; yes, so draw text interior 
4536 S.E. 50th BIX: pmi Bee aS ees Zope i 
Portland, OR 97206 Telex: 6502691013 pictTest 
BTST #pictBit,D4 s pret «2 
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BEQ iconNoTest 3; no, so it's an icon button 


BSR doPictInterior yes, so draw pict interior 


=e 


BRA drawn ; and jump on 
iconNoTest 
BSR  dolIconInterior ; draw icon interior 
drawn 


; all drawn 

; restore the entry pen state 
PEA entryPenState (A6) 
_SetPenState 


7 restore the entry clipping region, and get rid of its holder 
MOVE.L entryClipRgnCopy (A6) ,- (SP) 
MOVE.L (SP) ,-(SP) 
_SetClip 
_DisposRgn 


7; so long 
RTS 


; draw a shadowed outline for a button 


doShadOutline 
3; move to the starting point for the horizontal shadow line: (left+2,bottom) 
MOVE.W contrlRect+left (A2) ,- (SP) 
ADDQ.W #0002, (SP) 
MOVE .W contrlRect+bottom(A2) ,- (SP) 
_MoveTo 


rm Editor Features 


; draw a line to the right side of the horizontal shadow line: (right, bottom) Full control over foreground & background 





MOVE .W contrlRect+right (A2) ,-(SP) j j 
MOVE.W contrlRect+bottom(A2) ,- (SP) video attributes. ; 
taathes Access to the extended (graphics) char. set. 
én Line and box drawing. 
; draw a line to the top of the vertical shadow line: (right,top+2) Define and modify field attributes: 
MOVE.W contrlRect+right (A2) ,-(SP) . Bic as . Ales al ‘ Sy a , 
i * Defau * Auto Ta * Must Respon 
“eta oiges raquneneeanpiascbliaa ash mil Ai a * Numeric Test = Right Justify * Echo Data 
ADDQ.W #50002, (SP) « Display Only * UpperCase * Warning Only 
_LineTo * Test Range iy Data Type * Numeric Precision 
Test form utility. a 
; now draw an outline rect at (top, left, bottom, right) Generate program shell utility. 
PEA contrlRect (A2) | Field reorder utility. 
_FrameRect Temporary exit to DOS. 


Compile form definitions to .OBJ files. 


; all done 








ma n Time Library 
SORE SUR ee eee ae AS Oe Bae eT et AGI eminem nctinwiie sim sornarer intent ttnensbti t Routines are color (CGA, EGA, VGA) / 
monochrome independent. 
; draw a simple outline for a button Forms are processed in dynamic memory. 
User written validation routines can be 
doSimpOutline linked to fields. 
String, Byte, Integer, Long, Real, and Double 
; draw an outline rect at (top, left,bottom, right) data types are supported. 
PEA contrlRect (A2) ® Scrolling fields. 
_FrameRect Run time library source code included. 
Run time library includes (plus others): 
; all done * load_form( ) *put_fielid() =get_form() 
erelease_form() «=put_form() «®clear_form_buffer () 
RTS edisplay form() get_field() «alter_tield_attrib ( ) 
* —---—--- -- ~~ -- shadOutIntClip ---------------------------- * No royalties. 


+ set the clip region for the interior of a shadowed outlined button 





ystem Requirements 


shadOutIntClip e IBM PC/XT/AT/PS2 or compatible. 
e PC-DOS or MS-DOS 2.0 or later 


7 use the rect at (top+2,leftt+2,bottom-2, right-2) 


MOVE.L contrlRect+top (A2) , interiorClipRect+top (A6) . 2 
MOVE.L contrlRect+bottom(A2) ,interiorClipRect+bottom (A6) rd eri ng i nformation 
ADDI.L #$00020002, interiorClipRect+top (A6) MC/VISA/Checks. Prices 
SUBI.L #$00020002, interiorClipRect+bottom(A6) : : 
PEA interiorClipRect (A6) Demo disk available. edb oat ; vaste 
a Call for shipping Microsoft C.. .. . $149.95 
; all do dates on other ver- LatticeC...... . $149.95 
eae eh sions. Tarte © a. os 55 . $149.95 
RTS 
a bia ARR oa TS a Ra a sinpOutintChlis .-<-<<<<+-<<-<<< <<< ® 


3 set the clip region for the interior of a simply outlined button 


simpOutIntClip 





3 use the rect at (top+2,left+2,bottom-2,right-2) 
MOVE.L contrlRect+top(A2),interiorClipRect+top (A6) 


(continued on next page) CIRCLE NO. 148 ON READER SERVICE CARD 
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dBASE Programmers 


You need it! 
C® You can handle it! 
(7 dB2c is here now! 


dB2c Offers: 

¢ Version 2.0 complete with 
Translator and File 
Handlers. 

¢ Extensive implementation 
of dBASE Ill+ with over 200 
functions and commands in 
C source code. 

¢ Contains our own File 
Handlers plus interfaces for 
Lattice's dBC and Faircom's 
c-tree. 

¢ Supports screen I/O with 
ANSI.SYS or fast assembler 
routines. 

¢ Support for Microsoft, 
Lattice and Turbo C 
compilers. 

¢ Tutor features of trans!ation 
combined with familiar 
syntax of the library eases 
the transition to 'C’. 

¢ One version supports MS- 
DOS, Xenix, Unix, OS-9 
and Concurrent DOS. 


are you 
ready? 





Toolkit $299 


Call or Write: 
SOFTWARE 
DAVID |. CONNECTION, INC. 


POB 712, Ely, MN 55731 
MARSH (218) 365-5097 
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TO THE MACS 


Listing Three (Listing continued, text begins on page 90.) 


MOVE.L contrlRect+bottom(A2) ,interiorClipRect+bottom (A6) 
ADDI.L #$00020002, interiorClipRect+top (A6) 
SUBI.L #$00020002, interiorClipRect+bottom(A6) 
PEA interiorClipRect (A6) 
_ClipRect 
7 all done 
RTS 
Fe me me en ae en es ee ee mem em mem a noOutIntClip <<< SH eens eens we * 


+ set the clip region for the interior of a non-outlined button 
noOutIntClip 


# use the rect at (top,left, bottom, right) 


MOVE.L contrlRect+top(A2), interiorClipRect+top (A6) 
MOVE.L contrlRect+bottom(A2) ,interiorClipRect+bottom (A6) 
PEA interiorClipRect (A6) 
_ClipRect 
; done 
RTS 
Be a oe aa en eee Sn mn hmm mes doTextinterlor q--<<-<- <<< enema ee * 


; draw a button's text content, in an indicated font 
doTextInterior 


7 get a pointer to the current grafPort into A4 


PEA currentGrafPort (A6) 
_GetPort 
MOVEA.L currentGrafPort (A6) ,A4 


; we may be using a font other than the window's, so save current font settings 
MOVE.L txFont (A4),curFontAndFace(A6) ; font and style 
MOVE.W txSize (A4) , curSize(A6) 3; size 


; the control's font is indicated by a value in the control record's contrlValue 
; field: -1 for the window's font, 0 for the System font, 1 for the application 
; font, anything else a standard Mac font number 


; in the case of a font other than the System or window's font, the font style 
; is in the ContrlMin field, and the font size is in the contrlMax field 


7; Case out on the font 
MOVE .W contrlValue (A2) ,DO 


BMI useWindowsFont 


; see if the new font is the System font or something else 


TST .W DO 
BEQ useSystemFont 
useCustomFont 
; set the font, style, and size for a font other than the System or window's font 
MOVE.W DO, txFont (A4) 7; set the font 
MOVE .W contrlMin (A2) ,txFace (A4) 7; set the style 
MOVE.W contr1lMax (A2) ,txSize (A4) ; set the size 
BRA figgerFontInfo 
useSystemFont 
7 set the font, style, and size for the system font (all zeroes will do it) 
CLR.L txFont (A4) ; set the font and style 
CLR.W txSize(A4) ; set the size 
useWindowsFont 


* we're using the window's current font, so font number, size, and style already set 


figgerFontInfo 

7; so the font's set up -- let's get some more information 
PEA fontInfo (A6) 
_GetFontInfo 


; from that info, we can figure the vertical positioning for the button's text 
; the equation: vertPos = rectBottom - (fontDescent + ((rectHeight-fontHeight) /2) ) 


MOVE.W interiorClipRect+bottom(A6) ,DO *; bottom - top gives rectHeight 
MOVE.L DO,D7 7 bottom will be used again 
SUB.W interiorClipRect+top(A6) ,D0O 

SUB.W fontInfotascent (A6) ,DO ; then subtract fontHeight 
SUB.W fontInfo+descent (A6), DO 

ASR.W #1,D0 ; divide what's left by 2 
ADD.W fontInfo+descent (A6) ,DO ; add it to the descent 

SUB.W DO,D7 ; then subtract it from bottom 


; determine whether we'll be drawing the control's title or a STR resource 
; if the control hilites via a content change and is hilited and there's a handle to 
; the STR resource, we draw the STR resource 


(continued on page 75) 
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PAINLESS WINDOWS. 





Windows. Data Entry. Menus. 
Finally,a C programmers’ tool that makes 
them as easy to use as prinif(). 

With Greenleaf DataWindows”, 


you move in quantum leaps! 


MES Snazzy Window Treatments 


DataWindows represents an important 
breakthrough in C programming tools. It 
sets you free so you can create exciting 
programs quickly and easily, saving both 
time and money! Developed to work with 
the IBM PC, XT, AT, compatibles, and 
MSDOS or PCDOS, DataWindows is a 
carefully tooled system of C functions which 
will jazz up your programs with 
unprecedented efficiency. 





Greenleaf DataWindows is integrated 
windows, transaction data entry, pop-up, 
pull-down, and Lotus style menu systems 
with: 
® Screen Management. You don’t have to 
remember what’s on the display or the 
sequence in which you put it there. 
DataWindows does the grunt work. 
There are no restrictions. 


™ Transaction Data Entry. Data entry 
windows can have any number of fields 
with sophisticated options for reading 
many data types. Calls are made to help, 
validation, and other functions. Full 
featured text editing, protected and 
mandatory fields, dBASE type picture 
strings, context sensitive help, validation 
of fields and transactions, redefinable 
keys, password entry, attribute control, 
keyboard idle and much more. 


™ Device Independence. It detects the type 
of display adapter your computer is using 
and adjusts to it automatically for CGA, 
EGA, or monochrome. Logical video 
attributes are easy to use for color or 
monochrome. 

™ Compatibility. Runs with Microsoft 
Windows and IBM TopView. 


™ The Greenleaf Tradition of Quality. Reliable 
products. Professional documentation that 
gets you up and running quickly and 
keeps you there. Reference card. 
Newsletter and Bulletin board. 


IBM, Microsoft & dBase, are registered trademarks of International 
Business Machines, Microsoft Corporation & Ashton-Tate respectively. 
PCDOS, IBM PC, XT, AT, & TopView are trademarks of IBM; MSDOS 
and Microsoft Windows are trademarks of Microsoft Corporation. 





EERE Stop Window Shopping Ez 


Order Today. Or call toll free for a free 
demo of the windows library that makes 
all the others obsolete. 


Order any of these high performance 
tools by calling your dealer or 
1-800-523-9830 today. Specify compiler 
when ordering. Add $8 for UPS second 
day air, or $5 for ground. Texas residents 
add sales tax. MasterCard, VISA, P.O., 
check, COD. In stock, shipped next day. 


Greenleaf DataWindows $225 
DataWindows Source Module $225 
The Greenleaf Comm Library v2.0 $185 
The Greenleaf Functions v3.0 $185 
Digiboard Comm/4-II $325 
Digiboard Comm/8-II $535 





GREENI.EAT- 





16479 Dallas Parkway, Suite 570 
Dallas, TX 75243 


Call Toll Free 


1-800-523-9830 
In Texas and Alaska, call 


214-248-2561 
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SGRMeeNEs Window Dressings Saas 


™ Simple or Complex Windows. Up to 254 
powerful overlaid windows 
simultaneously, all with just one kind of 
window to remember! Yet any window 
can be from one character to 32K! 


™ Easy Window Operations. DataWindows 
lets you move, zoom, frame, title, change 
colors, titles, frames, size, location, and 
make windows visible or invisible at will! 
Functions set cursor, attributes, and write 
data to any window or “current window’. 
Word wrap, auto scroll, keyboard 
functions. 


™ Write to Any Window Any Time. Windows 
may be visible, overlaid, or invisible, and 
you can write to them anyway. What you 
write will be seen when the windows 
become visible. 


® DataWindows is fast! It writes directly to 
video memory (in some modes). 


™ Easy to save! Any window, complete with 
attributes, can be saved on disk quickly 
and efficiently. 


™ Source code available. No royalties. 
EEE Also from Greenleaf: = 


The Greenleaf Functions v3.0 
The most complete, mature C language 
function library for the IBM PC, XT, AT 
and close compatibles. Includes over 225 
functions — DOS, disk, video, color text 
and graphics, string, time/date, keyboard, 
disk status and Ctrl-Break functions plus 
many more. 


The Greenleaf Comm Library 
Our 2.0 version is the hottest 
communications facility of its kind. Over 
120 functions — ring buffered, interrupt 
driven asynchronous communications for 
up to 16 ports simultaneously with 
XMODEM, XON/XOFF, many many 
sophisticated features. 


We support all popular C compilers for 
MSDOS/PCDOS: Microsoft, Lattice, 
Computer Innovations, Aztec, DeSmet, 
and others. 





ALL GAIN, 





NO PAIN 





Blow away the 640K barrier 


Gain the benefits of protected 
mode the easy way with OS/286™ 
and OS/386™. These tools for C, 
Fortran, Pascal and Assembly 
language programmers permit 
rapid conversion of existing DOS 
applications from “real” 8086 
mode to “protected” 286 and 386 
mode. They don’t replace or mod- 
ify DOS, but extend it to protected 
mode. 


OS/286 and OS/386 are the only 
DOS extenders that span both the 
286 and 386 processors, with 32- 


bit capability today on 386s that | 


yields twice the performance of 


16-bit mode. OS/286 and OS/386 | 


have quickly become the prefer- 
red solution for developers of high 
performance, memory-intensive 
applications, including CADKEY, 
CASE, and Gold Hill, and premier 
language developers Lahey, 
and Metaware. 


Our optional TOUCHDOWN ™ 
BIOS supplement provides fast 
and reliable protected mode oper- 
ation on any 286 system, even 
those with problems resetting the 
286. (Ever notice how few existing 
machines Operating System/2 
runs on?) 


If your applications are run- 
ning out of memory or need more 
speed, don’t wait for the “solu- 
tion” that means abandoning 
your investment in DOS. 
Enhance them now _ with 
OS/286 and OS/386 — products 
not promises. 



































OS/286"™ & OS/386™ Benefits: 


¢ Gain multi-megabytes of direct- 
ly addressable memory (15-Mb- 
286, 4Gb-386) 


* Increase performance by elimi- 
nating overlays and EMS 


¢ Convert in days, not months 


¢ Continue to work with a DOS 
interface and use existing TSRs, 
device drivers, graphic routines, 
etc. 


¢ Stay compatible with the widest 
array of systems 
A.I. Architects Software Devel- 
opers Kit $495 
includes full support for: 
* MetaWare High C (16 & 32 bit) 
¢ Professional Pascal (16 & 32 bit) 
¢ Lahey F77L FORTRAN 
¢ Microsoft C & Fortran 4.0, 
* MASM, MS-Link 
¢ Phoenix PLINK&86 
* Halo & GSS Graphics 
¢ Pharlap 386: ASM/LINK 
more to come 


Run time licenses for OS/286 
and OS/386 are available at 
nominal cost. 


MAKE BIG PROGRAMS 
RUN FASTER 
IN PROTECTED MODE 
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The HummingBoard™ 
turns any XT or AT into the fastest 386 
system available. The dual processor 
architecture boosts performance sig- 
nificantly over comparable single 
Processor systems or accelerator 
boards. Available with 2 to 24Mb 
RAM, 16 or 20Mhz speed, and 387 
floating point coprocessor. 


AI. 


Architects, Inc. 


One Kendall Square, Cambridge, MA 02139 
TEL (617) 577-8052 FAX (617) 577-9774 


OS/286, OS/386 and HummingBoard are trademarks of AL Architects, Inc., High C and Professional Pascal are 
trademarks of Metaware, Inc., F77L FORTRAN is a trademark of Lahey Computer Systems, Inc., Microsoft and MS-DOS are trademarks of Microsoft Corp. 
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Listing Three (Listing continued, text begins on page 90.) 


3; content change ? 

BTST #chngBit,D4 

BEQ useTitle 3; mo content change, so use control's title 
3; control hilites via a content change 
° is dt Aitited 7 

MOVE.B contrlHilite(A2),D0 


BEQ useTitle 3; O=active, not hilited, so use control's title 
ADDQ.B #1,D0 
BEQ useTitle 3; 255=inactive, not hilited, so use control's title 


3; control hiltes via a content change, and it's hilited 
3 do we have a handle to the content change string ? 
MOVE.L firstRsrcHndl(A3),D5 
BEQ useTitle 3; no, so use control's title 


useSTR 
; okay, we'll be using a content change STR resource, and we have a non-NIL handle 
3; lock the resource, put a pointer to it into D5, and set a flag 

MOVEA.L D5,A0 ; handle into AO 

_HLock ; lock the STR resource 

MOVEA.L D5,A0 

MOVE.L (A0Q),DS 


. 


set a pointer to it 


-e 


MOVE.W #1,usingCCRsrc (A6) 7; set a flag 
BRA setStrWidth 
useTitle 


; using the control's title 
; put a pointer to the string into D5, and clear a flag 
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LEA contrlTitle(A2),A0 
MOVE.L AO0O,D5 ; set a pointer 
CLR.W usingCCRsrc (A6) ; clear a flag 
setStrWidth 
: now, the horizontal positioning: start by getting the button's string's width 
SUBQ.L #2,SP ; room for function result 
MOVE.L DS, — (SP) ; the string 
_StringWidth 


3 now, use that width to get the horizontal positioning 
the equation: horzPos = rectLeft + ( (rectWidth-stringWidth) / 2) 


se 


MOVE.W interiorClipRect+right (A6) ,DO ; get rect width ( right - left ) 
SUB.W interiorClipRect+left (A6) ,DO 

SUB.W (SP)+,D0 3; subtract string width 

ASR.W #1,D0 ; divide what's left by two 

ADD.W interiorClipRect+left (A6),DO0 ; and add in the left side of rect 


> now we have the horizontal and vertical starting position for string drawing 
; let's move there ... 


MOVE.W DO, -(SP) 3; the horizontal starting position 
MOVE .W D7,-(SP) 3; the vertical starting position 
_MoveTo 


; paint a button's interior's background, according to the button’s hilite state 
; and whether we're drawing a content change 


3; test for content change imminent 
TST.W usingCCRsrc (A6) 3; remember, we just set or cleared this flag above 


BNE cCImminentl ; flag set, content change imminent 


3; test the hilite state 


bkgHSTestl 

MOVE.B contrlHilite(A2),D7 

BEQ hSActivel 3; O indicates an active button 
bkgHSTest2 

ADDQ.B #1,D7 3; 255 indicates an inactive button 

BNE hSHilitl 3 1-253 indicates a highlighted button 
hSInactivel 


; the button is inactive, so paint interior background white 


cCImminent1l 
; a content change is imminent, so paint interior background white 


hSActivel 

; the button is active, so paint interior background white 
MOVEA.L (A5) , AO 
PEA white (AO) 
_PenPat 

hSHilitl 


3; the button is highlighted, so paint interior background black 


paintInteriorBkg 
; paint the button's interior background 





PEA interiorClipRect (A6) 
_PaintRect 


; draw the button's interior's text, according to the button's hilite state 
: and whether we're drawing a content change 





(continued on next page) 
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Get Your 
Disks Moving! 


gie™ or 
Re ato 





Fast -increase your effective pro- 
gram speed up to 10 times! Data 
that has been read from your hard 
disk is retained in your computer's 
fast internal memory for super 
fast access the next time you need 
it. 


Now Faster! - use the new Deferred 
Write option to cache disk Writes, 
for even faster processing. 






























Safe - use the Write Through 
option for maximum safety from 
system failures and power glitches. 


Smart - Hot LRU algorithm identi- 
fies and prioritizes sector chains 
and single sector accesses; ef- 
ficient hashing algorithm insures 
instant access to cached data. 





Adaptable - use up to 15 mega- 
bytes of extended or expanded 
memory, or up to half a megabyte 
of standard memory. Cache mul- 
tiple hard disks using standard 
BIOS interface or software driver. 





Easy - installs with one statement; 
requires no modification of your 
existing programs; transparent to 
all normal programs. 


Compatible - even with AutoCAD, 
removable media drives, disk parti- 
tioning software. . . 


Includes - Vkette diskette accel- 
erator, Vscreen mono accelera- 
tor, Vkey keyboard accelerator. 


e005 Scerevmae 
GOLDEN BOW SYSTEMS 


2870 Fifth Avenue 
Suite 201 
San Diego, CA 92103 


800/284-3269 


Vcache operates with DOS systems. Vcache isa 
trademark of Golden Bow Systems. AutoCAD isa 
trademark of Autodesk Inc. DOS is a trademark of 
Microsoft Corp. and International Business 
Machines Corp. 
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Listing Three (Listing continued, text begins on page 90.) 


; clear a flag that, if set, signals an inactive button 
CLR.B D6 


; test for content change imminent 
TST.W usingCCRsrc (A6) 
BNE cCImminent2 + flag set, content change imminent 


; test the hilite state 


txtIntHSTestl 

MOVE.B contrlHilite(A2),D7 

BEQ txtHSActive2 3; 0 indicates an active button 
txtIntHSTest2 

ADDQ.B #1,D7 ; 255 indicates an inactive button 

BNE txtHSHilit2 ; 1-253 indicates a highlighted button 
txtHSInactive2 


; the button is inactive, so we'll draw the text in black, 
then gray it out 


ADDQ.B #1,D6 # set the inactive flag 
BRA drawText ; and jump to draw 


txtHSHilit2 
; the button is highlighted, so we'll draw the text in white 


MOVE.W #srcBic,txMode(A4) ; so the black bits show as white 
cCImminent 2 


; a content change is imminent, so we'll draw the text in black 


txtHSActive2 
; the button is active, so we'll draw the text in black 
drawText 
; draw the button's string 
MOVE.L DS, -(SP) + pointer to the string to draw 
_DrawString 


; if we used a STR resource, unlock it 


TST.W usingCCRsrc(A6) ; are we using ? 
BNE grayTest 7 no, so jump ahead 
MOVE.L firstRsrcHndl(A3),A0 7 yes, so get the handle 
_HUnlock # and unlock it 

grayTest 

7; see if we've got an inactive button, in which case we gray the text 

out 

TST.B D6 
BEQ txtGetNorm # not inactive, so no graying out 


yup, we're inactive, so let's get grayed out 
set the pen pattern to gray 


se Se 


MOVEA.L (AS) ,A0 
PEA gray (AO) 
_PenPat 


and set pattern transfer mode to ANDing with the inverse of the 


™e 


pattern 
MOVE #PatBic,-(SP) 
_PenMode 
# mow paint the clip rectangle gray 
PEA interiorClipRect (A6) 
_PaintRect 
txtGetNorm 
* get things back to normal, in case they were changed 
* normalize the text transfer mode 
MOVE .W #srcOr, txMode (A4) 
#restore the window's prior font settings 
MOVE.L curFontAndFace (A6) ,txFont (A4) 
MOVE.W curSize (A6) ,txSize(A4) 
textDrawn 
# text button interior's all drawn 
RTS 
Benn nn nn GBELCE LEC OLL OS re a ™ 


; draw a PICTure interior for the button 


doPictInterior 

*; we'll draw in the picture's bounding rectangle 

; we'll try to center this rectangle horizontally and vertically 
; din the control's clipping rectangle 

; if the control's too small, the icon lines up against 

; the top and or left sides of the control's clipping rectangle 


* move clipping rectangle's top and left coords into place 
MOVE.L interiorClipRect+top (A6) ,pictRect+top (A6) 


76 





7 get the clipping rect's width into D6 
MOVE.W interiorClipRect+right (A6) ,D6 
SUB.W interiorClipRect+left (A6) ,D6é 


get a pointer and handle to the picture 
if the control hilites via a content change and is hilited, 


we draw the secondary 


=e «Fe 


PICT resource 
does the control hilite via a content change ? 


=e Me 


BTST #chngBit,D4 
BEQ usePictOne ; doesn't hilite via a content 
change 
; is the control hilited ? 
MOVE.B contrlHilite(A2),D1 
BEQ usePictOne ; Omactive, not hilited 
ADDQ.B #1,D1 
BEQ usePictOne 3; 255=inactive, not hilited 
usePictTwo 
# we'll be using the secondary PICT resource 
; get a handle and set a flag 
MOVE.L secondRsrcHndl(A3),D5 ; the handle 
BEQ usePictOne ; in case of a NIL handle 
MOVE.W #1,usingCCRsrce (A6) ; the flag 
BRA getPictPointer 
usePictOne 
*; we'll be using the primary PICT resource 
*; get a handle and set a flag 
MOVE.L firstRsrcHndl(A3),D5 ; the handle 
BEQ pictDrawn ; in case of a NIL handle 
CLR.W usingCCRsrc (A6) ; the flag 
getPictPointer 


; lock the PICT, and get a pointer to it 
MOVEA.L D5,A0 


_HLock # lock the PICT 

MOVEA.L DS,A4 

MOVEA.L (A4),A4 * get a pointer 
figPicWidth 


+ figure the picture's width 
MOVE.W picFrame+right (A4),D1 
SUB.W picFrame+left (A4) ,D1 


# now subtract the picture's width from the clip width 
SUB.W D1,D6 


; if 2 or more, divide by 2 and use as horizontal offset 


; if it's < 2, no horizontal offset 
CMPI.W #2,D6 
BLT.S doPictRight 


divide and add the offset in 
ASR.W #1,D6 ; divide by two 
ADD.W D6, pictRect+left (A6) 


ve 


# now do the right coord of rectangle 
doPictRight 
MOVE.W pictRect+left (A6),pictRect+right (A6) 
ADD .W D1, pictRect+right (A6) 


* get the clipping rect's height 
MOVE.W interiorClipRect+bottom(A6) ,DO 7 get clip height into DO 
SUB.W interiorClipRect+top(A6) ,DO 


figure the picture's height 
MOVE.W picFrame+bottom(A4),Dl1 
SUB.W picFramet+top(A4),D1 


se 


now subtract the picture's height from the clip height 
SUB.W D1,DO 


=e 


if 2 or more, divide by 2 and use as vertical offset 


we fe 


if it's < 2, no vertical offset 
CMPI.W #2,D0 
BLT.S doPictBottom 


divide and add the offset in 
ASR.W #1,D0 ; divide by two 
ADD.W DO, pictRect+top (A6) 


7 


# now do the bottom coord of rectangle 
doPictBottom 
MOVE.W pictRect+top(A6) ,pictRect+bottom (A6) 
ADD.W Dl, pictRect+bottom(A6) 


# clear the background 


PEA interiorClipRect (A6) 
_EraseRect 
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; okay, let's draw the picture (remember, it gets clipped to the button's interior ) 


MOVE.L D5, -(SP) ; the picture's handle 
PEA pictRect (A6) ; the destination rectangle 
_DrawPicture 


3; unlock the PICT 


MOVEA.L D5,A0 ; handle's still here 
_HUnlock 


3; now, adjust the picture for buttons that are hilited inverts or inactive 


BSR interiorAdjust 
pictDrawn 
; pict button interior's all drawn 
RTS 
apn so ai a al a al a la SUG EI AA ag ee ree * 


; adjust a button's interior for buttons that are hilited inverts or inactive 
interiorAdjust 


3; test the hilite state 


hiliteTestl 

MOVE.B contrlHilite(A2),D0 

BEQ intAdjDone ; 0 indicates a non-hilited active button 
hiliteTest2 

ADDQ.B #1,D0 3; 255 indicates an inactive button 

BNE itsHilited 3 1-253 indicates a highlighted button 
itsInactive 


3 the button is inactive, so we'll gray it out 
7; set the pen pattern to gray 


MOVEA.L (AS) ,A0 
PEA gray (AQ) 
_PenPat 


; and set pattern transfer mode to ANDing with the inverse of the pattern 
MOVE #PatBic,-(SP) 
_PenMode 


; now paint the clip rectangle gray 


PEA interiorClipRect (A6) 
_PaintRect 
3; leave 


BRA intAdjDone 


itsHilited 
; the button is highlighted 
3; test for being an invert 
TST.W usingCCRsrc (A6) 
BNE intAdjDone ; a content changer, so we done 


3 the button's a hilited invert, so invert it 
PEA interiorClipRect (A6) 
_InverRect 


intAdjDone 
3 all done with the adjustment 
RTS 


; draw an ICONic interior for the button 
doIconInterior 


| ; we'll draw in an icon-sized rectangle 


we'll try to center this rectangle horizontally and vertically 
in the control's clipping rectangle 

if the control's too small, the icon lines up against 

the top and or left sides of the control's clipping rectangle 


were Se Me 


; move clipping rectangle's top and left coords into place 
MOVE.L interiorClipRect+top (A6) ,iconRect+top (A6) 


; get the clipping rect's width into DO 
MOVE.W interiorClipRect+right (A6) ,DO 
SUB.W interiorClipRect+left (A6) ,DO 


3 now subtract the icon width 
SUBI.W #iconSize,D0O 


if 2 or more, divide by 2 and use as horizontal offset 
if it's < 2, no horizontal offset 

CMPI.W #2,D0 

BLT.S doIconRight 


se 


se 





(continued on next page) 
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MULTITASKING 


With 
MultiDos Plus 
‘‘multitasking for the IBM-PC.’ 


Ideal for developing applications 
in process control, data acquisi- 
tion, communications, and other 
areas. Check these features which 
make MultiBos Pius an unbeat- 
able value. 


e Run up to 32 programs concur- 
rently. 

e Your software continues to run 
under DOS. No need to learn a 
new operating system. 

e Use the compilers you already 
have. Supports software written in 
most languages. 

e Operator commands to load/run 
programs, change priority, check 
program status, abort/suspend / 
resume programs. 

e Programmatic interface via INT 15H 
for the following. 


* |Intertask message communica- 

tion. Send/receive/check mes- 

sage present on 64 message 

queues. 

Task control by means of 

semaphores. Get/release/check 

semaphores. 

* Change priority-256 priority 

levels. 

Suspend task for specified 

interval. 

Spawn and terminate external 

and internal tasks. 

Disable/enable multitasking. 

and more! 

e Independent foreground /back- 
ground displays. 

e Access to DOS while applications 
are running. 


Hardware/Software Requirements 


IBM PC/XT/AT or true clone. Enough 
memory to hold MultiDos Pius (48 
KB) and all your application programs. 
Also may need 4 or 16 KB memory 
for ‘hidden screens’’ for each active 
task. MS-DOS (or PC-DOS) 2.0 or 
later operating system. 


only: $24.95 OR 
$99.95 


with source code 





Outside USA add $5.00 shipping and handling. 


Visa and Mastercard orders only call 
toll-free: 1-800-872-4566, ext. 350., or 
send check or money order to: 


NANOSOFT 


13 Westfield Rd, Natick, MA 01760 
MA orders add 5% sales tax. 
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bivigrertlelamllele-1¢(-) 
disassemblers 

compilers 

text editors 

text filters 
communications support 
text formatters 


interpreters 


Users’ Group 
Library 


bulletin boards 





co-routines 
compiler compilers 


window packages 


A Directory 
assemblers of Public Domain 
games C Source Code 


tutorials 

math packages 

link editors 

Tate [¥r-Te [3 

cross compilers 

pre-processors 

function libraries 

disassemblers 

compilers Miche) 24 . 


text editors 
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COMPLETE DEVELOPMENT SYSTEM 
FOR MACHINE CONTROL 
APPLICATIONS : 


TINY188 is a low cost “PC somewhat com- 
patible” engine for OEM controller applica- 
tions. A selection of high level languages is 
available in ROM. 


DDS188 An optional development board with 
EPROM programmer, floppy disk controller 
and added memory, removes to lower target 
system cost. 


Prices start at $269 each/$99 at 1,000. 


Vesta Technology, Inc. 
(303) 422-8088 
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for Version Control 
PC Tech Journal says... 


TLIB™ is 
FASTEST! 


Times are for updat- 
ing a 45K library on a 
PC/XT. All benchmark 
results except TLIB 4.0 
are from Sept 87 PC 
Tech Journal review. 


0:09 
TLIB 4.0 


“,..packed with features... excellent...” Jim 
Vallino, PC Tech Journal Sept 87 


“,..has my highest recommendation.” Ronny 
Richardson, Computer Shopper Aug 87 
MS-DOS 2.x & 3.x Just $99.95 + $3 s/h Visa/MC 


BURTON SYSTEMS SOFTWARE 
P.O. Box 4156, Cary, NC 27519 


(919) 469-3068 
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Listing Three (Listing continued, text begins on page 90.) 


; divide and add the offset in 
ASR.W #1,D0 ; divide by two 
ADD.W DO, iconRect+left (A6) 


7 now do the right coord of rectangle 


doIconRight 
MOVE.W iconRect+left (A6),iconRect+right (A6) 
ADD.W #iconSize,iconRect+right (A6) 


; get the clipping rect's height 
MOVE.W interiorClipRect+bottom(A6) ,DO 7 get clip height into DO 
SUB.W interiorClipRect+top (A6) ,DO 


# now subtract the icon height from the clip height 
SUBI.W #iconSize, D0 


; if 2 or more, divide by 2 and use as vertical offset 
; if it's < 2, no vertical offset 

CMPI.W #2,D0 

BLT.S doIconBottom 


; divide and add the offset in 
ASR.W #1,D0 ; divide by two 
ADD .W DO, iconRect+top (A6) 


# now do the bottom coord of rectangle 


doIconBottom 
MOVE.W iconRect+top (A6) ,iconRect+bottom (A6) 
ADD.W #iconSize, iconRect+bottom (A6) 


; get a handle to the icon 

; if the control hilites via a content change and is hilited, we draw the secondary 
; ICON resource 

7 content change ? 


BTST #chngBit,D4 

BEQ uselIconOne 
; hilited ? 

MOVE.B contrlHilite(A2),D1 

BEQ useIconOne 

ADDQ.B #1,D1 

BEQ uselIconOne 
useIconTwo 


; we'll be using the secondary ICON resource 
+ get a handle and set a flag 
MOVE.L secondRsrcHndl(A3),D5 ; the handle 


BEQ useIconOne ; in case of a NIL handle 
MOVE.W #1,usingCCRsrc (A6) ; the flag 
BRA clearBack + and jump ahead 


useIconOne 
# we'll be using the primary ICON resource 
* get a handle and set a flag 


MOVE.L firstRsrcHndl(A3),D5 ; the handle 
BEQ iconDrawn 7 in case of a NIL handle 
CLR.W usingCCRsrc (A6) ; the flag 
clearBack 
; clear the background 
PEA interiorClipRect (A6) 
_EraseRect 


; Okay, let's draw the icon (remember, it gets clipped to the button's interior ) 


PEA iconRect (A6) ; the destination rectangle 
MOVE.L DS5,-(SP) ; the icon's handle 
_PlotIcon 


; now, adjust the icon for buttons that are hilited inverts or inactive 
BSR interiorAdjust 


iconDrawn 


+ icon button interior's all drawn 
RTS 


Renn doTestCntl ---------~-------------------- * 
; the application wants CDEF to test a point to see if it's in an active control 


doTestCntl 


+ first, see if the control's even active, or if it's in one of the two inactive modes 


MOVE .B contrlHilite(A2),D7 zinactive control ? 

CMPI.B #inact254,D7 

BEQ setReturn2 7yes, so return appropriate code 
CMPI.B #inact255,D7 

BEQ setReturn3 syes, so return appropriate code 


; the control has been found to be active 
* now find out if the supplied point is in the control's rectangle 
SUBQ.L #2,SP ; room for the function result 
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MOVE.L D3, -(SP) ; param holds the mouse coords 

PEA contrlRect (A2) ; pointer to the control's rectangle 
_PtInRect 

TST.B (SP) + 3 scan result while chucking 

BEQ setReturn3 + if point isn't in the control ... 


; Okay, the control's active, and the mouse point’s in it 
; the control has no separate parts, 30 we return the whole control's part number 
setReturnl 

MOVE.L #wholePartNumber, theResult (A6) 

RTS 


7; and here are the return codes for the other possibilities 


setReturn2 
MOVE.L #254,theResult(A6) ;inactive type 254 
RTS 
setReturn3 
MOVE.L #0, theResult (A6) zinactive type 255 
RTS 70r not in control 
bat ta: cae amines ta oak oa alas atalcalacaaas Te cae GOCE LCCCHEL ete eh ee ® 


3; calculate the control's region 


doCalccCntl 
MOVE.L D3,-(SP) 3; param holds the waiting handle 
PEA contrlRect (A2) 3 use the control's rectangle 
_RectRgn 
RTS 
Ri aS eS SE BOR Cen Gers re ea . 


; do any special initialization of the control 


; in this case, set up a control data block 
; then load in any necessary resources, and store handles in the control data block 


doInitCntl 

3; try to get a control data block 
MOVE.L #cntlDataBlokSize, DO 
_NewHandle, CLEAR 


; store the result 
MOVE.L AO0O,contrlData (A2) 


BEQ initDone ; if we got no block, leave 
lockDataBlock 
MOVEA.L AO,A3 ; save a copy of the block's handle 
_Hlock ; lock the block down 
MOVEA.L (A3),A3 3; get a pointer to the locked block 
initTextTest 
; is this is a text control ? 
BTST #textBit,D4 ; the test 
BEQ initPictTest 3; no, so jump on 
got a text control - does it indicate hiliting via a content change ? 
BTST #chngBit,D4 ; the test 
BEQ initPictTest ; no, so jump on 


3; got a text control with content change hiliting, so load in the string resource and lock 
x 

SUBQ.L #4,SP ; room for a handle 

MOVE.L #'STR ',-(SP) ; the resource type 
MOVE .W contrlRFcon(A2),-(SP) ; the resource id 


_GetResource try to grab that resource 
MOVE.L (SP)+,firstRsrcHndl (A3) store its handle (possibly NIL) 
BRA initDone 

initPictTest 

; see if this is a PICT control 
BTST #pictBit,D4 ; the test 
BEQ initIconTest ; no, so jump on 


; got a pict control, so load in the main PICT 


SUBQ.L #4,SP ; room for a handle 

MOVE.L #'PICT',-(SP) ; the resource type 

MOVE.W contrlRFcon+t2 (A2) ,- (SP) ; the resource id 

_ GetResource ; try to grab that resource 

MOVE.L (SP) +, firstRsrcHndl (A3) 3 store its handle (possibly NIL) 
isPictCc 
3 does it indicate hiliting via a content change ? 

BIST #chngBit,D4 ; the test 

BEQ initDone 7; no, so done 


(continued on page 82) 
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MetaWINDOW 


Product of the Month" 
"... a technological tour de 
force for fast PC graphics." 


NO ROYALTIES! 


Hh 


| MetaWINDOW provides an expand- 
|ed set of graphic drawing functions, 
| plus the added functionality and 


performance required for designing 
multi-window desktop applications. 


auto-cursor tracking 
pull-down menus 
pop-up windows 


comprehensive 
graphic functions 


e multiple fonts 10Point 12 Point 


Display multiple bitmap or 
"filled-outline" fonts. 

Face fonts for bold, italic, under- 
line or strike-out stylings. 

Full "RasterOp" transfer 
functions for writing, erasing, 
rubberbanding or dragging: 
lines, text, icons, bit images 
and complex objects. 

Create pop-up menus, 
windows and icons. 

¢ Supports IBM's new PS/2 VGA 
and MCGA graphics. 
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Turbo Tech Report 





TURBOS | 
TECH =": 
REPORT: 
Turbo Watch 


SESE SORT 
Turbo Tech Report wilt make 

a3 point io address the entire 
Turbo Fascal programming 3 
community, by discussing the __,, 
issue of porting code acress 

the three Turbe Pasoai 
anvirenments. 


Speaks Your Language. 





The newsletter/disk publication for Turbo Pascal® users 


Are you looking for powerful utilities written in Turbo 
Pascal that you can use to develop software or incorporate 
into your programs? Are you interested in improving and 
expanding your Turbo Pascal programming skills? 
subscription to Turbo Tech 
Report, the bimonthly newsletter /disk publication from 
the publishers of Dr. Dobb’s Journal and Micro/Systems 
Journal. Each issue delivers more than 250K of Turbo 
Pascal source code programs on disk, and 24+ pages of 
Turbo Pascal software and book reviews, and 


Then you deserve a 


articles, 
se and commentary. 

t's the only publication 
ico such focused tech- 
nical articles with code on 
disk. Each valuable issue 
contains: 

¢ Articles on topics like 
speedy 3D graphics, math- 
ematical expression parsers, 
creating global gotos, mem- 
ory resident and AI applica- 
tions and more—all written 
by Turbo experts. 

¢ Reviews of the latest 
Turbo Pascal software pro- 
grams from companies like 
Borland International, Blaise 


Se eee eee 


—Yes! 1 want a one-year subscription to Turbo Tech Report (6 
issues with 6 disks) for $99. 

[_] PC/MS-DOS {_] Macintosh 

CP/M: [_] Kaypro (| Osborne [_] Apple 


Format: 


PAYMENT MUST ACCOMPANY ALL ORDERS 


[_] Check/money order enclosed. 


[_\] Charge my: —— VISA ~~M/C —— AmExp. 


Card * 





Exp. 

LE: ee nit eR OPE Oa a 
PNR ONYC sprees plaeeniciepiahadbabpiamient deine Nae ig eee nt oe pe ra 
FLA |S 3 SRP coe Rs cE MU ie Er A Te RE SO ons a Reiner at 


City State 








Orders outside U.S.: add $30. 
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Computing, Media Cybernetics, Nostradamus, and more! 

¢ News and commentary detailing the latest 
products and developments in the Turbo Pascal 
programming community. 

¢ A disk filled with Turbo Pascal code! You'll get 
the Turbo Pascal utilities and routines discussed in the 
newsletter’s articles, as well as applications developed by 
Turbo users from around the world. You'll receive 
programs that make labels, generate menus, provide 
faster screen access, transfer files, and more! 


If you're an expert Turbo 
Pascal programmer or a 
novice interested in 
expanding your Turbo skills, 
you need a publication that 
speaks your language: Turbo 
Tech Report. Subscribe 
today at the special price of 
just $99—that’s 33% off the 
regular price of $150. To 
order by credit card, call toll- 
free 1-800-533-4372. Or 
mail the coupon with your 
payment to Turbo Tech 
Report, 501 Galveston 
Drive, Redwood City, CA 
940063. 
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For Free Info... 


Start Here 


Smart buyers start with DDUs free 
information card, a shopping center filled 
with information about the products and 
services advertised in this very issue: everything from softwar: 
and systems to peripherals and professional support services 

And smart buyers can use this free information card to 
quickly and easily gather a comprehensive file of facts, figures 
and product specs to sort out competing claims. Using DDUs 
free information card can prevent you from making the wrong, 
costly buying decision. 

Be a smart shopper. Complete and mail this postage paid 
card today! 
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TO THE MACS 


Listing Three (Listing continued, text begins on page 90.). 





NEW AND IMPROVED 


























Version w # got a pict control with content change, so load in the secondary PICT 
SUBQ.L #4,SP + room for a handle 
MOVE.L #'PICT',-(SP) ; the resource type 
MOVE.W contrlRFcon (A2) ,- (SP) 7 try to grab that resource 
ca & MOVE.L (SP)+,secondRsrcHndl (A3) 7 Store its handle (possibly NIL) 
BRA initDone ; done 
initIconTest 
; mo test needed; we have an icon control, so load in the main ICON 
h SUBQ.L #4,SP 7 room for a handle 
Lite MOVE.L #'ICON',-(SP) ; the resource type 
Only MOVE.W contrlRFcon+2 (A2),-(SP) ; the resource id 
i _GetResource ; try to grab that resource 
Disassembler MOVE.L (SP)+,firstRsrcHndl (A3) ; store its handle (possibly NIL) 
That isIconcc 
ifeve < ; does it indicate hiliting via a content change ? 
. BTST #chngBit,D4 ; the test 
Down BEQ initDone 3 no, so done 
' 
DATA! # got an icon control with content change, so load in the secondary ICON 
SUBQ.L #4,SP 7 room for a handle 
MOVE.L #'ICON',-(SP) ; the resource type 
MOVE.W contrlRFcon (A2) ,- (SP) ; the resource id 
_GetResource ; try to grab that resource 
MOVE.L (SP)+,secondRsrcHndl (A3) ; store its handle (possibly NIL) 
¢ Fully disassembles both .EXE arene ge een 
; ; that's it for initialization 
and .COM files! ara 
e Flow- and Seg. Reg. Data-trace 
finds SEGs, PROCs, & Data a REMAN a ee ae EO NE oe ea RON ee ca ene A Ee O.* 
Areas! 
; do any special disposal operations for the control 
e Outputs SEGMENT & PROC 
pseudo-ops at proper places. + in this case, release resources whose handles are stored in the control's 
: ; data block, then release that block 
¢ Outputs data areas via proper 
form of DB/DW (ASCII text as doDispCnt1 
strings others as hex value) ; see if we ever got a control data block 
‘ : TST.L contrlData (A2) 
e Labels both code & data. Labels BEQ dispDone 3 no block, so leave 
of form ‘Hxxxxx’ where ‘xxxxx’ is 
h ff f b , : f checkFirst 
ex oflset trom eginning O 7; see if there's a handle in the first slot 
program. TST. GL firstRsrcHndl (A3) 3 got a real handle ? 
BEQ checkSecond 7 no, it's NIL, so jump ahead 
NEw! MOVE.L firstRsrcHndl (A3),-(SP) ; handle okay, so let go of that resource 
ec ‘ _ReleaseResource 
e User may easily input locations 
of multiple pgm. areas (if reqd.). checkSecond 
; see if there's a handle in the second slot 
= 8086/88/186/286 op-codes, TST.L secondRsrcHndl (A3) 7; got a real handle ? 
(‘real’ addressing mode). BEQ dropDataBlock # no, it's NIL, so jump ahead 
: MOVE.L secondRsrcHndl(A3),-(SP) ; handle okay, so let go of that resource 
e DOS function calls commented _ReleaseResource 
to show operation performed. 
dropDataBlock 
e Output format fully compatible 7 now get rid of the control's data block 
, dl MOVEA.L contrlData (A2),A0 
* 1k 
with IBM /Microsoft “DiapésRandle 
assembler input. 
dispDone RTS 
© For IBM* PC*/XT*/AT* & com- . 
. patibles, 128K+, DOS 2.0+. #------------------------------------- doPosCnt] ----------------------------- * 
#8634-22 PC-DISnDATa 2.0 ; the position routine 
(5%” disk & manual) ...... $165 ; in this case, do nothing 
U.S. Funds only, drawn on a U.S. bank. 
RO doPosCntl RTS 
Add $3 shipping (U.S. & Canada), $10 5 ay 
(overseas air) per item. Ohio residents 
please add local sales tax. A CRLETRE St TEE A a SEE eS aie aint a ss sine oblast ae hs nile wt * 
*Registered trademark, IBM Corporation. 
**Registered trademark, Microsoft Corp. ; the thumb routine 
To order, phone (513) 435-4480 (M-F, 7, Re Sane Ee eee iing 
9a.m.-5p.m., EST), or send check, money doThumbCnt 1 RTS 
order, or VISA/MasterCard information 
(name, street address (No P.O. box please) 
card number, expiration date, and your ae Nae ae ee eR RE ee Sige Oe Paratha tales ete * 
telephone number) to: 
PRO/AM SOFTWARE + the drag routine 
220 Cardigan Road + in this case, do nothing 
Centerville, OH 45459 acbeagonel ook 
513) 435-4480 
Professional Software for a ae Serer neal eeanennes DORNCSTEESE Sea eee * 





both Novice and Expert 
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; the track routine 
; in this case, do nothing 


doAutoTrack RTS End Listing Three 


Listing Four 





+ aeeeivahrn: in ~aiasae sa taaiaain a natalia aed aitaal ine airdidd Ble o> File: intetmation) \<9+s—36s se . 
* * 
* rectCDEFEqu.Txt * 
* * 
* x 
* Private definitions for rectCDEF.Asm * 
* * 
* Edited with QUED/M 2.04 * 
* Compiled under MDS 2.01 * 
* * 
* Written and ©1987 by Stan Krute. All rights reserved. No part of this file,* 
* or the object code it leads to, may be reproduced, in any form or by any * 
* means, without the express written permission of the author and copyright * 
* holder. * 
x *- 
* Timestamp: 1:56 am EST September 29, 1987 = 
* Spacestamp: 21E Halcyon Drive West Yarmouth, Massacusetts 02673 * 
x * 
* This file looks good in 9 point Courier, QUED/M 2.04 tabs set to 3 ® 
* * 
Ka we ee ee ee  eeeereeerereereereereerseresecerereeoeeeeeeeeeee * 
re ee ee SQUSCOS Sater See ee * 


3; stack frame offsets for function parameters 





returnAddress EQU 4 ; return address' offset in frame 

param EQU 8 ; for long-word-size parameter 

message EQU 12 ; control message identifies desired operation 
theControl EQU 14 ; calling control's handle's offset in frame 
varCode EQU 18 3 which variation of the control 

theResult EQU 20 ; function result offset in frame 


3; stack frame offsets for automatic (local) variables 





entryPenState EQU -18 3 room to hold entry pen state (18 bytes) 
currentGrafPort EQU =22 ; pointer to current grafPort ( 4 bytes ) 
curFontAndFace EQU -26 ; saved font number and style ( 4 bytes ) 
curSize EQU -28 ; saved font size ( 2 bytes ) 

fontInfo EQU -36 ; information about current font ( 8 bytes ) 
entryClipRgnCopy EQU -40 ; handle to copy of entry clip region (4 bytes) 
interiorClipRect EQU -48 ; a clipping rectangle (8 bytes) 

pictRect EQU -56 ; a PICTure bounding rectangle (8 bytes) 
iconRect EQU -56 3 an ICON bounding rectangle (8 bytes) 
usingCCRsre EQU = ; flags use ofcontent change resource (2 bytes) 
autoBytes EQU 58 ; size in bytes of automatic variable area 


; hilite codes 
inact254 EQU 254 ; hilite code to inactivate control 
inact255 EQU 255 3; hilite code to inactivate control 





3 icon stuff 





iconSize EQU 32 ; width and height of icon 

3 id's for our control definition 

wholePartNumber EQU 10 j; part number for our whole control 

; test bits 

textBit EQU 7 ; if set, it's a text button 

pictBit EQU 6 -, ££ eet, J¢%s.a. PICT .dSutton 

iconBit EQU 2 3; if set, it's an ICON button 

outBit EQU 4 ; if set, the button is outlined 

shadBit EQU 3 ; if set, the button's outline is shadowed 
bareBit EQU z ; if set, the button has no outline 

invBit EQU a : if set, the button shows hiliting via inversion 
chngBit EQU 0 : if set, the button shows hiliting via content change 


3; the control's data block 


entlDataBlokSize EQU 8 : size of the control's data block 
firstRsrcHndl EQU 0 ; offset of first data block field 
secondRsrcHndl EQU 4 ; offset of second data block field 


End Listing Four 
Listing Five 


this file is called rectCDEF.Link 


©1987 by Stan Krute --- all rights reserved 
timestamp: 12:57 am EST September 26, 1987 
7 spacestamp: 21E Halcyon Drive West Yarmouth, Mass. 02673 


turn off code listing to map file 





(continued on next page) | 
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Locate C Bugs 
before they Bite with 


PC-lint 


PC-lint will analyze your C 
programs (one or many modules) 
and uncover glitches, bugs, quirks, 
and inconsistencies. It will catch 
subtle errors before they catch you. 
By examining multiple modules, 
PC-lint enjoys a perspective your 
compiler does not have. 





Stephen D. Cooper, Blue Notes 
San Francisco PC Users Group 





Don Malpass, [EEE Softwar 


Gimpel Software 


3207 Hogarth Lane 
Collegeville PA 19426 


(215)584-4261 


PRICE: $139.00 first copy, $100 each 
additional, MC, VISA, COD, PA residents 
add 6% sales tax, Outside USA add $15. 


Runs on MS-DOS, works with any C 
compiler - direct support for 12 major C 
compilers including Microsoft 5.0, Turbo, 
C86+, Lattice, Datalight, Desmet 

PC-lint is a trademark of Gimpel Software. 
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PRODUCTION 
LANGUAGES CORP. 


PRODUCTION QUALITY 


68020 
ANSI C Compiler 


Full 68020 instruction set 

Full 68881 support 

ANSI Standard reentrant library 
Extensive Sybolic Debug information 
Internal consistancy checking 
Position independant code 


ROMable code 


PC Hosted cross-compiler 
single user license $ 
VME 68020 compiler 

single CPU lisence $ 
ANSI standard reentrant 
library source code 


995.00 
1995.00 


$ 800.00 


SPECIAL OFFER 


For a limited time only we are offering full 
library source FREE with the purchase of either 
68020 C compiler 


817-599-8366 
P.O. Box 109, Weatherford, Texas 76086 
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Conquer Time 
and Space. 


Introducing XO-SHELL. 


Pop-Up Productivity for Programmers. 







No matter what language you program in, XO-SHELL will help 

you hurdle the barriers to working faster and more efficiently 

by eliminating programming hassles. Only with RAM-resident 

XO-SHELL can you: 

@ DO CROSS-REFERENCING without leaving your editor 

@ VIEW ANY FILE and TRANSFER ANY SECTION into your 
editor or to your printer 


@ VIEW, COPY and ERASE files directly from a SCROLLABLE 
DIRECTORY DISPLAY 


@ With a single key stroke RETRIEVE previous DOS commands, 
then EDIT and REEXECUTE them 


@ DO SOURCE-LISTING while in your application 


@ OBTAIN KEY-CODES without a reference and without going 
through difficult interpretation 


@ INSERT GRAPHICS CHARACTERS in your source code. 
XQ-SHELL is for PCs, XTs, ATs, PS/2s, compatibles. 


WN. $49 


M plus $5 shipping & handling 


Call today toll-free 
ects (800) 635-5011 


701 Concord Avenue In MA: (617) 868-7704 
Cambridge. MA 02138 Visa, MasterCard 
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TO THE MACS 
Listing Five 
(Listing continued, text begins on page 90.) 





; the name of the input file is rectCDEF.Rel 
rectCDEF.REL 


; the name of the output file is rectCDEF 
/Output rectCDEF 


; set a type and creator for the output file 
/Type “eee. *Seeee 


; end of Linker control file 


5 End Listing Five 


Listing Six 


* this file is called rectCDEF.RO 
* ©1987 by Stan Krute == all rights reserved 


* timestamp: 
* spacestamp: 


12:53 am EST 
21E Halcyon Drive 


September 26, 1987 


West Yarmouth, Mass. 02673 


* name of the output file is rectCDEF.Rsrc, type is RSRC, 

creator is RSED 
rectCDEF.Rsre 
RSRCRSED | 


* grab code resource 1 and turn it into a purgeable control 
definition 

TYPE CDEF = PROC 

,40 (32) 


rect CDEF End Listing Six 


Listing Seven 


* this file is called rectCDEF.RI1 
* ©1987 by Stan Krute -- all rights reserved 


* timestamp: 
* spacestamp: 


12:41 am EST September 26, 1987 


21E Halcyon Drive West Yarmouth, Mass. 02673 


* name of the input and output file is custom controls demo 


!:custom controls demo 


* grab CDEF resource from rectCDEF.Rsrc 
INCLUDE :rectCDEF.Rsre are hie 
End Listing Seven 





Listing Eight 
* this file is called rectCDEF.R2 
* ©1987 by Stan Krute -- 


all rights reserved 


* timestamp: 
* Spacestamp: 


12:41 am EST September 26, 1987 


21E Halcyon Drive West Yarmouth, Mass. 02673 


* name of the input and output file is custom controls demo PROJ 


-rsre !:custom controls demo PROJ.rsre 


* grab CDEF resource from rectCDEF.Rsre 
INCLUDE :rectCDEF.Rsre 


End Listings 
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Where do you find good 
Ada proprammers? 





You could spend and spend 
trying to hire good Ada programmers 
and still not find what you need. Big 
demand; short supply. The irony 
is, your best Ada people may be the 
programmers you already have; all 
they need is good training. 

Alsys offers a full range of quality 
Ada training products for growing your 
own programmers. For example... 


™ A 27 video tape seminar covering 
the entire Ada language-18 hours 

of authoritative instruction by the 
principal designer of the language 
itself. Benefit? Understanding Ada’s 
architecture and scope should be 

the foundation for all further work or 
study. It will help develop that most 
elusive skill: the Ada programming 
intuition to guess right. 


M™ For programmers ready for 
hands-on skills development, a 
comprehensive CAI course on a PC, 
running 50-60 hours, with exer- 
cises and progress tracking. Multiple 


* Ada is a registered trademark of the U.S. Government (AJPO). 


Free 
Poster : 
—6see 
coupon. 


users. Licenses for 5 machines. The 
course is also excellent for brushing 
up, or extra work on one subject, or 
for new employees. 


Good Ada training for your own 
people. For Ada now. Write or call. 


Sus 


Ada Programmers 
Are Made —Not Hired. 


™@ For practicing, and then moving 
directly to serious Ada programming, 
Alsys offers a full-featured, production 
quality Ada compiler, with tools, 

for the PC AT. This same compiler is 
used to build some of the largest Ada 


programs in 
existence! In the US: Alsys Inc., 1432 Main St., Waltham, MA 02154 Tel: (617) 890-0030 
In the UK: Alsys Ltd., Partridge House, Newtown Rd., Henley-on-Thames, Oxon RG9 1EN Tel: 44 (491) 579090 
Alsys Offers — intherest of the world: Alsys SA, 29 Avenue de Versailles, 78170 La Celle St., Cloud, France Tel: 33 (1) 3918.12.44 
































more trainin ee 
products oa | send me POSTER and more information on: DDJ 3/88 
CAI course for ____Ichbiah, Barnes & Firth on Ada 27-tape Video Series. 
programmers ____ Lessons on Ada CAI Course. ______ Live Training. 
familiar with | _____ PC AT Compiler and Tools. | ______ AdaQuery On-Line Reference. 
Fortran... | _____- You Know Fortran, Ada ts Simple CAI Course. 
a searchable, _____ Ada Immersion Combination Package. 
on-line version | Name 
of the Reference 

Compan 
Manual... | otic! 
a(limited) | Adktess 
offering of live | City State Zip 
training courses. | Phone ( ) EXt. 


Mail to: Alsys, Inc. 1432 Main St., Waltham, MA 02154 
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Now _ in" CC" fttt! 


Two and Three Dimensional Geometry 
The added plus you need for developing sophisticated 
computer graphics,;CAD,and programs that use compu- 
tational geometry. Y 
You save time and 
money with its 
flexibility. 


TurboGeometry 
An excellent addi- Li b r a r y 


tion to Borland's 

Turbo Graphix 

Tool Box. 

Over 150 ready to use two & three dimensional 
routines, such as Geometric Equations « Intersections 
Curves « Arcs » Circles * Lines * 2&3 Dimensional 
Transforms « Polygons « Hidden Lines « Volumes 
Perspectives « Clipping * Areas and many more 
Manual, full source code and sample programs. Only 
$99.95US. Add $5.00 for S&H in US. TexRes add 8% 
ST. 30 day guarentee. VISA,MC,MO,Chk PC(Comp), 
Turbo Pascal 2.0+,4.0,&C. DOS 2.0+. When ordering, 
indicate language. ORDER YOUR LIBRARY TODAY!! 


DISK SOFTWARE, INC., 2116 E. Arapaho, #487 
Richardson, Texas 75081 (214) 423-7288 
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Parallel Programming for “C” 


INTERWORK™ 


A Concurrent Programming Toolkit 











Interwork is a “C” program library which allows you to write 
your programs as a set of cooperating concurrent tasks. Very 
useful for simulation, real-time applications, and experimenta- 
tion with parallel programming. 


FEATURES 

* Supports a very large number of tasks (typically more than 
100) limited only by available memory. Low overhead per 
task results in very fast context switching. 

* Provides a full set of inter-task communication (ITC) 
facilities, including shared memory, locks, semaphores, 
blocking queues, and UNIX™-style signals. Also has building 
blocks for constructing your own ITC facilities. 

* Handles interrupts (DOS version) and integrates them into 
task scheduling. Supply your own interrupt handlers or 
block tasks on interrupts. 

* Lets you trace task switches and inter-task communication. 

* Comes with complete documentation including a user's 
manual and reference manual of commands. 


Interwork is available for the following systems: 











































Hardware Operating System 
IBM PC, XT, AT PC-DOS 2.0 or later $129 
IBM PC AT XENIX™ $159 












DEC VAX" SUN UNIX 4.2BSD 


PC-DOS version is compatible with DeSmet, Lattice, and 
Microsoft C compilers. 

Please specify hardware and operating system when order- 
ing. Shipping and handling included; COD orders add $2.50. 
Send check or money order to: 


Ax Block Island Technologies 
Innovative Computer Software 


13563 NW Cornell Road, Suite 230, Portland, Oregon 97229-5892 
(503) 241-8971 

Trademarks: Interwork, Block Island Technologies; UNIX, AT&T Bell Laboratories, Inc.: XENIX, 

Microsoft, Inc.; VAX, Digital Equipment Corporation 
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86 . 








Program maddints; 






Const max = 180; 









A, 





PROGRAMMING 


Listing One (Text begins on page 108.) 


{ This program illustrates addition of two 180 x 180 integer 
{ matrices A and B, storing the results in a similar matrix C 


arrayPtr = “bigArray; 
bigArray = array [1..max, 1..max] of integer; 


{ maximum columns/rows per square array } 




















B, C : arrayPtr; 
X, Y : word; 


Procedure acquire (var D : arrayPtr); 


{ Allocates the array on the heap and fills it with data } 
{ This is a sample procedure for demo only. Replace it with } 


{ the requisite 
Var Yi, Cc: ¢ Word: 


Begin 
New (D); 


code to acquire data from an external source } 


{ allocate a node } 


For r := 1 to max do 
For c := 1 to max do 


D(a} = 


~ 


(xr * 10) + c; { value of each array element 


Begin { main program } 


Acquire (A); 
Acquire (B); 
New (C); 


| C* [ve-s] <= 


Writeln; 





{ acquire array data } 


{ set aside space for result } 


For y := 1 to max do 
For x := 1 to max do 


AM fv, @1 4% 3B ifys- xh { add arrays into C } 


Writeln (’Proof:’); 

Weitein (7A 415.3) =) °5:* 11,1192 
Writein ('B {1, 14 = "',. B*- fi, 11): 
Mritein ¢°C {1,: 4} ~ “= 0% 435-9 


Writeln (’A [max, max] = ’, A* [max, max]); 


Writeln (’B [max, max] = ’, B* [max, max]); 
Writeln (’C [max, max] = ’, C* [max, max]); 


End. 


Listing Two 


Program hugemats; 


End Lising One 


{ Demo program to add two huge matrices > 64K, giving a third } 


Const maxRows = 250; 
maxCols = 300; 


Type dataObj = word; 
colPtr = “colArray; 


colArray = 


array [1..maxCols] of dataObj; 


colNode = record 
col : colPtr; 


End; 


rowArray = 





Var row : word; 





rowPtr = “rowArray; 


array [1..maxRows] of colNode; 


Var A, B,; CC: rowPtrs: 


X, y : word; 

error : Boolean; 
{ promme no nnnn nnn nn nnn nnn nn nn nnn nana nn nnn nn nnn nnn n nnn wane nanan } 
Procedure create (var D : rowPtr; 


var error : Boolean); 


{ Create huge array ’D’ and pass back pointer to it } 


| Begin 
Error := false; 
If maxAvail > sizeof (rowArray) then { if space availéhbie } 
GetMem (D, sizeof {reowArray) ) { allocate row aryviauy } 
Else begin 
D := nil; 
Error := true; 
End; 
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THE PROGRAMMERS SHOP 


helps save time, money, and cut frustrations. Compare, evaluate, and find products. 















FREE Programmer’s Update 
Magazine 

“Keeping Professional Programmers Current with 
Developer's Technology.” Programmer's Update 
lives up to its motto witha viewpoint unique to this 
industry. We use our experience and contacts to 
bring you articles about intriguing software trends 
and technical issues, interviews with authors and in- 
novators, news about products, surveys, insightful 
commentary and predictions, valuable resource list- 
ings. You can get a FREE sample copy today by 
calling our toll-free number. Mention “DD388". A 
personal subscription is just $25 a year. 
Our Services: 

* Dealers Inquire 

» Newsletter 

* Rush Order 


* International Sales Desk 
* Compare Products 

* Help find a Publisher 

* Evaluation Literature FREE * Over 700 products 

+ Programmer's Update « National Accounts Center 


386 Development Tools | 





386 Assembler/Linker PC $ 389 
386 Debug - by Phar Lap PC’$ 129 
386/DOS Extender PC $ 919 
DESQview PS/2 PC $ 109 
F77L-EM - by Lahey MS Call 
High C - by MetaWare PC. Cail 


OS/286 & 386 by Al Architects PC Call 
Paradox 386 MS $ 799 


AN Br: TalelUr-le(-t— 


APT - Active Prolog Tutor - build 
applications interactively PC $ 49 
ARITY Prolog - full, 4 Meg 
Interpreter - debug, C, ASM PC $ 229 
COMPILER/Interpreter-EXE PC $ 569 
Cogent Prolog Compiler MS $ 179 
MicroProlog Prof. Comp./Interp. MS $ 609 
PC Scheme LISP - by TI PCS -85 


Star Sapphire MS $ 429 
TransLISP - learn fast MS $ 79 
TransLISP PLUS MS $ 149 


TURBO PROLOG by Borland PC $ 69 
Others: IQ LISP ($239), IQC LISP ($269) 


Basic 
BAS_C - economy MS $ 179 
BAS_PAS - economy MS $ 135 
Basic Development Tools PC $ 89 
db/Lib MS $ 119 
Exim Toolkit - full PC $ 45 
Finally - by Komputerwerks PC $ 85 
Inside Track PC $ 49 
Mach 2 by MicroHelp PCS. 8 
NetWorks by Exim PC 3» 89 
QBase - screens MS $ 79 
QuickBASIC Gah 


Quick Pak-by Crescent Software PC $ 59 
Quick-Tools by BC Associates PC $ 109 
Stay-Res PC. 3 .59 
True Basic PG’ $3 679 
Turbo BASIC - by Borland PC $ 69 
Turbo BASIC Database Toolbox MS $ 69 


FEATURES 


SofTRAN, the Translation and Text Lan- 
guage by TransOptima - full procedural 
language like C plus pattern and 
nonprocedural constructs cuts develop- 
ment effort by upto 16times. PC $ 349 

FORCE III, Dbase Compiler by Sophco- 
small .EXEs, user-defined functions, I/O 
directives through BIOS/DOS/ANSI/ 
FORCE /user-defined, extensions include 
FOR..NEXT loops, soundex, | D arrays. 
Maverick. PC $ 109 


Program Objectively — for Less 


Object-oriented programming tools free you from 
trivia tracking, make sophisticated applications 
practical quickly. 


Consider ACTOR, full language and environment 


that lets you replace 100’s of lines of code with 
justa few. It just may be the next standard language. 
Regularly $419 ($495 retail), until March 31, 
1988 only $399. 


HOOPS by Ithaca Software lets you assign at- 
tributes to objects for advanced graphics applica- 
tions. Include hidden line/surface removal, multiple 
light source rendering, and more in 3D with ani- 
mation. Use natural language. Device independent, 
call from C, Pascal, or FORTRAN. Regularly 
$549 ($575 retail), until March 31, 1988 .... 

only $419. 


CALL TODAY for free detailed literature about these and other object-oriented tools. Take advantage 
of these special prices — order before March 31, 1988. Mention “DD388." 


RECENT DISCOVERY 


CLARION DBMS by Barrington Systems. 
Fast applications prototyping and 
development. Language, compiler, 
screen/report generators, editor, 
call other languages, read/write 
dBASE III + files. PC, List:$695 


Om H-Taleltr-Te [mi @felanl oli ie~ 


AZTEC C86 - Commercial PC $499 


C86 PLUS - by CI MS $359 
Datalight Optimum - C MS $ 99 
Instant-C/16M PC Call 
Lattice C - from Lattice MS $259 
Microsoft C 5.0- Codeview MS Call 
Microsoft Quick C MS Call 


Rex - C/86 standalone ROM MS $695 
Turbo C by Borland 


C Libraries-Files 


BTree by Soft Focus MS $ 69 
CBTREE - Source, noroyalties MS $ 99 
ctree by Faircom - no royalties MS $315 


rtree - report generation PC 3239 
dB2C Toolkit V2.0 MS $249 
dbQUERY - ad hoc, SQL-based MS Call 
dbVISTA - Object only MS Call 


Source - Single user 
dBx - translator 





C Worthy Interface Library PC $249 
Curses by Aspen Scientific PC $109 
dBASE Graphics for C PU 3 @ 


ESSENTIAL GRAPHICS - fast PC $185 


FontWINDOW/PLUS PC $229 
GraphiC - new color version PC $279 
Greenleaf Data Windows PC $155 

w/source PC $259 
Terminal Mapping System PC $279 


TurboWINDOW/C - for TurboC PC $ 75 


View Manager - by Blaise PC $199 
Vitamin C - screen I/O PC $159 

VC Screen PC $ 79 
Windows for C - fast PC Call 
Windows for Data - validation PC Call 
ZView - screen generator MS $149 





AtariST & Amiga 


We carry full lines of Manx & Lattice. 
DB) =y-te) =e er lale[er-lel= 


Clipper compiler 
dBase III Plus 






PC $399 
PC $429 


Call for a catalog, literature, and solid value 


800-421-8006 


THE PROGRAMMER'’S SHOP ~* 













laatal 
U Vv 


atocn A Ca aay 
Cle Ss Pe sep VETS 


5-D Pond Park Road, Hingham, MA 02043 
Mass: 800-442-8070 or 617-740-2510 1/88 
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RECENT DISCOVERY 


CO/SESSION - Remotely access PC and 
peripherals, train or trouble-shoot 
from off-site, 2 users on one program. 
Session record/playback, file transfer, 
terminal emulation, keyboard and 


voice modes. PC $229 
DB] SY-Ns) =a r-lale[Ur-le(-merelale 
dBASE ITI LANPack PC $649 


DBXL Interpreter by Word Tech PC $ 99 
FoxBASE+ Dev. - V2.0 MS $259 


Quicksilver by Word Tech PC $369 
DBASE Support 

dAnalyst PC $219 

dBase Tools for C PC. 3 65 

dBrief with Brief PC Call 

dBC III by Lattice MS $169 

dbug III MS $179 


Documentor - dFlow superset MS $229 
Genifer by Bytel-code generator MS $279 


QuickCode III Plus MS $189 
R&R Report Writer MS $139 
Seek-It - Query-by-example PC $ 79 
Silver Comm Library MS $139 
Tom Rettig’s Library PC $ 79 


UI Programmer - user interfaces PC $249 


DataBase & File Management 


CQL PY 3 359 


DataFlex by Data Access PC'S: 899 
DataFlex multiuser PC $1149 
Magic PC PC $ 699 
Paradox - original PC $ 369 
Paradox V2.0 PC $ 469 
Revelation by Cosmos Pe 179 


ULNA Ee Tave [else (mele) ) elezal 


BTRIEVE ISAM MS $185 
BTRIEVE/N-multiuser MS $455 
GSS Graphics Dev’t Toolkit |= PC $375 
HALO Development Package MS $389 
Graphics PS $209 
Help/Control - on line help PC $ 99 
HI-SCREEN XL PC $129 
HOOPS Graphics Library PC $549 


Informix 4GL-application builder PC Call 
Informix SQL - ANSI standard PC Call 
Instant Programmer’s Help MS $ 79 
NET-TOOLS - NET-BIOS PC. 3129 
Opt Tech Sort - sort, merge MS $ 99 


Norton Guides PC 3.75 
Panel Plus MS $395 
Pfinish - by Phoenix MS $209 
Report Option - for Xtrieve MS $109 
Screen Sculptor PC -$: 89 
SPSS/PC Plus PC $749 
Synergy - create user interfaces MS $329 
XQL - SQL for Btrieve MS $649 


Xtrieve - organize database MS $179 
ZAP Communications- VT 100 PC $ 89 
Note: All prices subject to change without notice. Mention this ad. Some prices 


are specials. Ask about COD and POs. Formats: 3" laptop now available. plus 
200 others. UPS surface shipping add $3/item. 


STRUCTURED 


Make your C language 


ident io 
programs os residen PROGRAMMIN — 
DMS RESIDENT-C 


Microsoft 





Listing Two 


Lattice (Listing continued, text begins on page 108.) 


If D <> nil then 
For row := 1 to maxRows do begin 
If not error then 
If maxAvail > sizeof (colArray) then { if space } 
GetMem (D* [row].col, sizeof (colArray)) { alloc row } 


“hot-key”’ enable 


{ allocate all rows } 


$79.95 $149.95 


w/source 


Make your assembler 
programs memory resident 
with 
DMS RESIDENT-ASM 


enable 


$149.95 
w/source 


American Software International 
PAS. BOK es 
Windsor, CT 06095-9998 
(203) 688-5054 


Barrier 


dBase to C conversion 
is now a reality 


Sooner or later you’re going to run into the dBase wall. It may 
come up unexpectedly. Maybe you know it’s there. But at 
some point you are going to need faster run-time, real 
portability, stronger code refinement, and source code security. 


Using dBx to translate your dBase code to C is the perfect way 
to break the dBase barrier. C is portable, fast, and flexible. C 
programmers appreciate our commented, clean K&R code. If 
you are new to C, dBx is a great way to get up to speed. Why 
not call us today and discuss your individual situation. 


PEE EE tibiae 


(203) 255-3400 


TELEX - 6502972226MCI 


303 Linwood Ave. 
Fairfield, Ct., 06430 
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Else 
Error := true; 


Procedure acquire (var D : rowPtr; 
var error : Boolean); 


{ Load data into array ’D’ after creating it } 
Var roW,. C2 word; 


Begin 
Create (D, error); 
If not error then 
For row := 1 to maxRows do 
For c := 1 to maxCols do 
D* [row] .col* [c] := (row * 10) + c; 


Begin { main program } 
Writeln (’Size of each array is ’, 
sizeof (rowArray) + (sizeof (colArray) * maxRows), 
’ bytes’); 
Writeln (’Initial heap space = ’, memAvail); 
Writeln (’Setting up array A’); 
Acquire (A, error); 


If not error then begin 
Writeln (’Remaining heap space = ’, memAvail : 6); 
Writeln (’Setting up array B’); 
Acquire (B, error); 

End; 


If not error then begin 
Writeln (‘Remaining heap space = ’, memAvail : 6); 
Writeln (’Creating target array C’); 
Create (C, error); 

End; 


If not error then 
Begin 
Writeln (’Remaining heap space = ’, memAvail : 6); 
Writeln (‘Adding arrays’); 
For y := 1 to maxRows do 
For x := 1 to maxCols do 
C“[y] .col* [x] := A*[y].col*[x] + B*[y].col*[x]: 


Writeln; 

Writeln (’Proof:’); 

Write CA 41, I} + 3B 13; °3) Ci,” tyes." )3 

Writeln (A*[1].col*[{1}] : 5, ’ + "oe BO ll) weit 25; °F 
Ct41} colt [2-2 SB): 

X := maxCols; 

Y := maxRows; 

Write (‘A [m, n) + B [m, n] = C [m, n] = ”); 

Writeln (A*[y].col*[x] : 5, ’ + ", B*[y].col*[x] : 5, ’ 
CALY] . cos {i> 2-3) 


End 
Else 
Begin 
Writeln (’Out of memory: program ended’); 
Write (#7); 
End; 
End. 


{ beep } 


End Listings 
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{ modify to suit } 


Our Assembly Language Program. 


ie: firmware for 8086/87/186 from object files generated by 
c Nh wie. 
seen Te Re Ne ee popular C compilers, such as from Microsoft, Lattice and 
1 8088 2 ae el cies 802a - Borland’s Turbo C, and MASM from Microsoft, Provides full 
| Soe \ LO } ¥ <86 ee control of segment placement anywhere in memory. Sup- 
ee . 
= - Fa ports output of Intel HEX file for PROM programmers, Intel 
ae. . \ wy, 7). } ~ OMF absolute object file for symbolic debuggers and in- 
2 \\ oem f circuit emulators. Includes Intel compatible linker, locator, 
The Visible \! ) ie The Visible librarian, hex formatter and cross reference generator. $350. 
{ 
sa Se te \ Vf | Com aon Ts NEW! Includes utility to support PC based PROM 
(Not Copy Protected.) \ Fd (Not Copy Protected] programmers. 
ne me " SYSTEMS & 
Software Masters” =] SOFTWARE: °°: %°. 


THE PROGRAMMERS SHOP 





provides complete information, advice, guarantees and every product for Microcomputer Programming. 


FIRMWARE DEVELOPMENT 


C, MASM PROM 
LINK & 
° “ LOCATE aap 


LINK & LOCATE enables PC users to produce ROM-based 










We’ve Added a New Teacher to 



















Introducing The Visible Computer: 80286—an advanced version of 
the “Award Winning” TVC: 8088. Its animated simulation of the PC’s 
microprocessor shows you exactly how assembly language instruc- 
tions are carried out. And it comes complete with a comprehensive 
400 p. manual. 

TVC lets you choose from 45 demonstration 
programs that can be executed with the sim- 
ulator—from simple register loads to advanced 
programs that manipulate interrupts and per- 
form file I/O. It makes learning assembly 
language. . . elementary! : ne 













The Visible Computer: 8088 for IBM PC/XT/AT and true compatibles; TVC: 80286 
for IBM AT. To order direct: Software Masters, 2714 Finfeather, Bryan, TX 77801; 
(409) 822-9490. Include $3.00 handling. Bank cards accepted. 


CIRCLE NO. 166 ON READER SERVICE CARD 


C Programmers: Combine C and COMMON LISP 


3303 Harbor Bivd., C11, Costa Mesa, CA 92626 


Phone (714) 241-8650 FAX (714)241-0377 TWX 910-695-0125 
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to Increase the Power of Your Software — 


with “TransLISP PLUS: 


for Only $99! 


Thorough. 








Simple. 





Add LISP features to your software without mak- 
ing it a full time job. The TransLISP PLUS tutorial, 
on-line help, and 30 sample programs with 
commented source make it easy. 






















Practical. 


Start by modifying the LISP sample programs 
and including them in a system you wrote in C. 
Yes, in C! TransLISP PLUS includes a C Language 
Interface that lets you integrate your Microsoft C 
code and libraries with all or portions of our LISP 
interpreter. 

Use TransLISP PLUS to add natural or command 
language features to replace menus... . or to flexibly 
manage related but disparate information. Code 
from C libraries provided by other vendors can be 
integrated into your program to perform tasks not 
normally part of LISP. 


List $318 


a—\ The Special Offer $99 
3) Coder’s Offer good from 1/1/88 to 3/31/88 


(¢ 









HOURS: 8:30 A.M.-8:00 P.M. E.S.T. 
5-DPond Park Road, Hingham, MA 02043 
Mass: 800-442-8070 or 617-740-2510 


™ i i > 
cea Source 541 Main St., Suite 412, So. Weymouth, MA 02190 


Call Today for FREE detailed information or try Risk-Free for 31 days, any product on this page. 


800-421-8006 


TransLISP PLUS took over 400 primitives from 
the most widely used and respected LISP standard, 
COMMON LISP, and made it available on IBM 
PCs, XTs, ATs, and virtually every other MSDOS 
machine. So now you can work with anything from 
a $700 PC to a $7000 PC. 

The utilities toolbox is included at no charge with 
a built-in editor, pretty printer, cross reference, 
and additional debugging tools. 

An optional Runtime encrypts your source code 
so that you can distribute your applications safely. 
You pay no royalties. 

Requires MSDOS 2.0 +. 320K RAM, and a 360K floppy 


Royalty FREE Offer 


This special offer from The Programmer’s Shop 
includes the $150 TransLISP Runtime. Create 
encrypted versions of your LISP source and dis- 
tributed unlimited copies without paying royalties 
to The Coder’s Source. You must order by 3/31/88 
to take advantage of this special offer. 


1-800-421-8006 













THE PROGRAMMER’S SHOP 


Your complete source for software. services and answers 
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COLUMNS 


TO THE MACS 


MultiFinder, HyperCard, and More on Custom CDEFs 


n case you missed January’s in- 

troductory column: I’m here to 
talk Mac. Mostly I'll provide code 
samples. There'll also be discussion 
of programming tools, notable appli- 
cations, conversations with program- 
mers, and _ interesting ROM/OS 
topics. 

This month I discuss three good- 
ies from Apple (MultiFinder, Hyper- 
Card, and a manual) and finish up 
the custom control definition 
(CDEF) code project I began last 
time. If you hadn't noticed, the 
Macintosh universe is going super- 
nova. Time to surf the flash... . 


MultiFinder Arrives 

Official production copies of Multi- 
Finder flew into my mountain aerie 
this month. (Although you will read 
this in February, I wrote it in October/ 
November.) Bottom line: I love it. A 
clean bit of work. Thanks, Apple 
people. I run it almost all the time. 
The exception, when I’m print spool- 
ing to my ImageWriter. That’ll 
change, probably by the time you 
read this. 

Meantime, a few thoughts: 


® Two Mbyte becomes the new mini- 
mum Mac RAM configuration. Think 
of the momentum Apple’d have if 
this chip-war silliness weren't hap- 
pening.... 

@There may finally be a blessed 
stop to “What would you do with 
(fill in the blank) Mbyte of memory, 
anyway?” questions, now that the 
obvious answer becomes even more 


by Stan kKrute 





so: Fill it with programs and data 
that work intelligently with one an- 
other so as to further enlarge the 
universe of possible computer users. 
® The major hole in this first version 
of MultiFinder: interprocess commu- 
nication facilities. To raise the intelli- 
gence of the computing environ- 
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ment, applications must be able to 
talk to one another, both demo- and 
autocratically. Apple seems to un- 
derstand this, so I figure this feature 
will show up in the next release. 
Plan ahead. 

@ Desk accessories, though sup- 
ported, have lost a big chunk of 
their prime raison d'etre: pseudomul- 
titasking. We've now got semimulti- 
tasking, with the full thing lurking a 
few months ahead. 

By the way, in case you don't 
know: with this release of MultiFin- 
der, holding down the Option key 
when invoking a DA opens it in the 
foreground application’s world 
rather than MultiFinder’s separate 
desk accessory layer—useful for vari- 
ous parasitic DAs (spelling checkers, 
macro engines, et al.). 

@The obvious hook into multi- 
tasking, GetNextEvent, has been 
used. If you guessed this three years 
ago, give yourself a no-prize. 

® Following my favorite thread in 
the Apple mythos, MultiFinder 
favors decentralization of control. 
Rather than use a_ central 
multiprocessing dictator, MultiFin- 
der gives applications the major say 
in CPU allocation. I like the implica- 
tions. 

@ If you haven't already, say good- 
bye to low memory. Say goodbye to 
tricky OS hacks. Say goodbye to 
direct writing to the screen. Say good- 
bye to event and window manager 
fiddling. Assume as little as possible 
about anything. Don't play no dirty 
tricks. 

Of course, capital-G Good Mac pro- 
grammers never did funniness for 
fun, anyways. They did it to get 


around some performance hole in 
the environment. So, OK, we won't 
do that anymore. But now it’s up to 
Apple to make sure the necessary 
functionality gets built into the offi- 
cial toolkit. And while youre at it, 
Cupertinians, how about a beefed- 
up Quickdraw/PostScript on a chip, 
please? 

It's not too hard to get your pro- 
grams “MultiFinder friendly.” Call or 
write APDA for technical documen- 
tation, sample code, interfaces, and 
so on. I'll also try to work up some- 
thing unique for the column. The 
docs I've got now are preliminary; 
by the time you read this, a lot more 
should be available. 


HyperCard, Too 
Another official arrival these past 
months: HyperCard. I like it a lot. 
We need a speedy and standard 
engine for accessing the gargantuan 
lased-out data piles that are loom- 
ing, and HyperCard will do just fine. 
HyperTalk, the HyperCard program- 
ming language, is simple, elegant, 
and powerful. Hits me as a nice 
synthesis of the history and state of 
computer languages, a sort of where- 
we-stand-today for the masses. I’ve 
done a fair amount of teaching pro- 
gramming, and this is a language I 
could use with all levels of learners. 
There's a lot of the Atkinson snap 
to HyperCard, along with his atten- 
tion to user interface and small im- 
plementation details. Quibbles? Well, 
there are the obvious things: You 
can only open a stack at a time. You 
can't resize the HyperCard window. 
There’s a fair amount of modality 
and isolation from other applica- 
tions. I have the feeling these things 
will get fixed. ? 
Want to program the sucker? Play 
with it. Examine/modify scripts. Scan 
Apple's HyperCard User Guide. Then 
go on to Danny Goodman's fine 
work, The Complete HyperCard Hand- 
book and APDA’'s HyperCard Techni- 
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"Breakthrough in interface management. Generate C code from Dan Bricklin’s Demo screens. Date fields. Full color support. Money fields. Fully 
programmable field behavior. Scrolling text within fields. Calculator style numeric input. User definable entry validation. Field marking. Orthogonal _ 
field movement. Specify fields by number or location. Source code included. Screen sizes limited only by memory. Interfaces with db__VISTA : 
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24 hour bulletin board. Higher level functions included. Object-oriented design. 
675 Massachusetts Avenue, Cambridge, MA 02139-3309 


Alllibrary functions are kept in separate modules. Nest screens as deep as desired. 
Design screens with Look & Feel screen designer. New device drivers can be created. 
800-233-3733 CALL 
617-491-7311 NOW 


Create as many screens as needed. No run-time license. Hexadecimal fields. Prefer- 
red by professionals and consultants. Microsoft. Cross referenced help system. 

PC/MS-DOS $299 (price includes C-scape, Look & Feel, source 

and manual). UNIX/others call. 30-day review. 


C-scape 2.0 


e Windows, windows, windows 
e Menus, menus, menus 

e Vast help system 

e Create any type of field 

e Data entry and validation 

e Smart borders 

e Extensive function library 

e Swappable device drivers 

e Easy to learn and use 

e Easy to maintain and modify 
e Unsurpassed flexibility 

e Professional manual 

e No royalties; no run-time license 
e Source code included 

e Demo package available 


e WYSIWYG screen design tool 

e Generates readable C code 

e Create menus and data entry 
screens 

e Define fields of any type 

e Variables, prompts, and validation 

e Line draw and erase 

e Block, move, cut, paste, copy 

e Horizontal and vertical scrolling 

e Edit Dan Bricklin Demo slides 

e Full color support 

e Fast, easy, and fun to use 

e Includes help 

e Full-feature demo available 












































by space aliens. Generate C code with Look & Feel screen designer. Context 
sensitive help system. Scroll lights. Read in screen definitions from disk files. 
Automatic vertical and horizontal scrolling. Batteries not included. Double and 
single line borders. Cross-referenced help system. Save and restore regions of the 
display. Nested menus. Quick C. Create screens from ASCII files. Easy to learn 
and use. Horizontal and vertical scrolling. Used by consultants and corporations 
worldwide. Easy to maintain. Professional documentation. Screen designer creates 
readable C code. Portable. Easily modifiable functions. No royalties. Source code included. Apollo and Data General. Professional support. 
Interface examples for data base management. Validation at keystroke level. Vast integrated and indexed context-sensitive help system. Save and 
restore regions of the display. Now supporting Quick C, Turbo C, Lattice, Microsoft, UNIX, XENIX, and others. And that’s not all. Call for demo. 
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The West Coast Computer Faire 
announces the first 
Computer Matchmaking Service. 


ee won't have to depend on fate at the 
13th West Coast Computer Faire to find the 
products and services that are the perfect 
match for your needs. 
We start you out on your path to high- 
tech bliss with Vertical Market Matching. 
We bring in the companies selling quality 
computers, software, peripherals, and add- 
ons—companies that meet the needs of peo- 
ple involved in specific business segments 
such as finance, medicine, manufacturing, law, 
education, engineering, and construction. 
And our Product Matching makes it 
easy for you to find the software, add-ons and 
upgrades for the Commodore Amiga, Apple II 
or Macintosh, IBM PC/MS-DOS, 
IBM PS/2, Atari, Lotus and more, 
that will keep you happily gazing 
into your Current system’s eyes. 
Plus, we counsel you on the latest 
techniques and insights in our WA 
outstanding Conference sessions. 





Fill out this coupon and mail with your check(s), for $15.00 for each registrant, postmarked by March 17th, 
1988. Include the names and addresses of registrants for whom you are enclosing a check. (Photocopy coupon for 


additional registrants. ) 

















The West Coast Computer Faire has 
made and will make more matches than any 
another computer show. It’s time we made the 
perfect match for you. 

Match your interests with these Faire 
Features: 
¢ Computer Art Gallery 
* Computer Faire Networks 
¢ Computer Music Demo 
¢ Computer-Aided Special Effects Demo 
¢ Exhibitor Presentations 
¢ Free Hands-On Classes, including Desktop 

Publishing, MS-DOS, Word Processing, Lotus 
1-2-3 
¢ Professional Development Seminars 




















The West Coast Computer Faire, Moscone 
Center, San Francisco, CA, April 7-10, 1988 


For information on exhibiting, call 
617-449-6600, x5077. But hurry — the 
Faire’s floor is almost full! 
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| Name Title | 

| Company | 

| Address | 

| City State Zip 

| Phone ( | 
Four day conference and exhibits $15.00 in advance. $20.00 at the door. Make check payable to “The West | 

| Coast Computer Faire.’’ Mail to: Attendee Registration Department, The West Coast Computer Faire, 300 First | 

Avenue, Needham, MA 02194. Advanced registrations accepted only with full payment and each registrant’s name 
| and address. Tickets will be mailed to each individual registrant separately. | 
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MUP WINER) RAIURIE April 7-10, 1988, Moscone Center, San Francisco, CA 
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TO THE MACS 
(continued from page 90) 


cal Reference Package. Also, Peter 
Olson, proprietor of Delphi's ICON- 
tact Mac forum, has written a sweet 
piece of shareware, Stackware Detec- 
tive, to let you peek a little deeper. 
Check it out, and remember to pay 
if you end up using it. 

My own HyperCard explorations 
are traveling along the XCMD and 
XFCN paths. These are hooks that 
let you add your own commands to 
HyperTalk. You can find details in 
the APDA docs. I'll be bringing you 
some samples in the near future. As 
PEEK and POKE are to BASIC, and 
slots are to the Apple II, the X twins 
are to HyperCard. 


One of the Great Docs 

Apple’s always impressed me with 
its documentation, especially the pro- 
grammers’ docs. | think of the early 
Applesoft manuals, the Apple Pascal 
books, Inside Macintosh, Bo Three 
Bob's tech notes, and on and on. 
There have always been individuals 
at the company who care about this 
sort of thing, realizing its impor- 
tance, and they've been able to mar- 
shal resources and produce. 

There's an especially nice docu- 
ment out that you may have missed. 
It's one that all Mac programmers 
should read, ponder, and pay atten- 
tion to. It’s title is Human Interface 
Guidelines: The Apple Desktop Inter- 
face, and it’s available from APDA. 

I know, the title’s not particularly 
exciting. But the content is, to me at 
least. Some of the more frustrating 
discussions I’ve had are with pro- 
grammers who just don’t under- 
stand why they should follow 
Apple's interface guidelines as 
closely as makes sense for their ap- 
plication. It’s not because all Apple's 
decisions are cosmically correct. 
They're not. But they’re darn close. 
And above all quibbling, consistent 
operational similarities between ap- 
plications empower users. Period. 

Please read this book, folks. 


Code Corner: Custom CDEFs, 
Part 2 


Resource Revelations 
Minor problem: As_ noted last 
month, I use ResEdit to build most 
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of my Macintosh program resources. 
It’s so Mac-like. But there’s no text 
file script left over. So how can I 
reveal custom controls demo’s re- 
sources to you? 

Macintosh Programmer's Work- 
shop (MPW) includes a Mac re- 
source decompiler, DeRez. It takes a 
file’s resources and produces a text 
file script description. It'd do the 
trick. But I don’t use MPW (yet?). 
Cruising Delphi, my favorite on-line 
hangout, I found a fine solution: 
Alan Dahlbom’s ResTools 2.01. It 
does much of what MPW’s Rez and 
DeRez do, uses a compatible C-like 
syntax, and is free. A big thanks to 


Alan for a fine piece of programming 
and a public service. 

So, Listing One, starting on page 
64, shows the ResTools 2.01 decom- 
pilation of most of the resources 
included in custom controls demo 
PROJrsrc. The syntax, as mentioned 
earlier, is C-like; if it doesn’t make 
immediate sense, go to Inside Mac 
and stare at the particular resource’s 
description. 

I've removed the decompilation of 
the file’s PICTs, ICONs, and ICN#s; 
these graphic resources look kind of 
silly as streams of hexits. Table 1, 
below, indicates where you can find 
images of the PICTs as well as the 















Microsoft. University 
offers the only systems 
training straight from 
the source. 


Microsoft University courses take you to the heart of our 
microcomputer software architecture. Our systems software 
curriculum combines in-depth technical presentations, 
problem-solving sessions, and practical hands-on workshops. 























Microsoft University Winter Quarter 








A MSe@ OS/2 Programming Environment (4 days) $1000 
BMS OS/2 Advanced Programming (5 days) $1250 
C MS OS/2 Device Drivers (4 days) $1000 * 
D MS OS/2 LAN Manager API Programming (5 days) $1000 
E Microsoft Windows API Programming (5 days) $1000 
F Advanced Microsoft Windows API Programming (5 days) $1000 
G Programming in Microsoft C (5 days) $ 800 
H 


Microsoft Macro Assembler (MASM) Programming (4 days) $ 800 








Courses held in both East and West Coast cities. 


FEBRUARY 1988 SCHEDULE 
Week of: Feb.1 . Feb.8 Feb.15  Feb.22 Feb. 29 
































. SEATTLE EGH ACE BDFGACE B,D FG 
IN, BOSTON** G E B F 
(SA... MARCH 1988 SCHEDULE 

Week of: Mar. 7 Mar. 14 Mar. 21 
SEATTLE A,B,C.E D,F,G A,B,E,H 
BOSTON** D C 









Call the Microsoft University Registrar 
and use your credit card to enroll now. 


(206) 882-8080. 


Microsott: 


Tuition is per person and includes 
all course materials. 














* For a limited time, this course also 
includes the Microsoft Device Driver 
Development Kit, a $300 value, at no 
additional charge. 














**Fees slightly higher in Boston. 
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C Tools From 
Books 


M&T 





¢C Chest and Other 
¢ Treasures 

from 

Dr. Dobb’s Journal 





by Allen Holub 


This comprehensive anthology contains the popular ”C Chest” 
columns from Dr Dobb's Journal of Software Tools, along with the lively 
philosophical and practical discussions they inspired, in addition to other 
information-packed articles by C experts. 

Topics covered include: pipes, wild-card expansion, and quoted 
arguments; sorting routines; command-line processing; queues and bit 
maps; utilities such as /s, make, and more; expression parsing; 
hyphenation; IBM cursor control and an Fget that edits; redirection; 
accessing IBM video display memory; trees; an AVL tree database 
package; directory traversal; sets; shrinking .EXE file images; hashing, 
expressions, and Roman numerals; and statistical applications of digital 
low-pass filters. 

All subroutines and programs are written in C and are available on disk 
with full C source code. MS-DOS format. 


Book & Disk (MS-DOS) Item #49-6 
Book item #40-2 


$39.95 
$24.95 


Special Packages 


CP/M C Package SAVE $27! 


Receive: Dr. Dobb's Toolbook of C, The Small-C Handbook, the Small-C 
Compiler, Small-Mac Assembler, and Small-Tools Text Processing 
Programs. Only $99.95! 


CP/M C Package item 005A $99.95 


MS-DOS C Package SAVE $22! 


Receive: Dr. Dobb’s Toolbook of C, The Small-C Handbook and MS-DOS 
Addendum, the Small-C Compiler, Small-Windows, and Small-Tools 
Text Processing Programs. Only $109.95! 


MS-DOS C Package item #005W $109.95 


¢ Disk Formats: Please specify MS-DOS or CP/M. For CP/M, 
specify: Apple, Kaypro, Osborne, Zenith Z-100 BDS/ DD, 
8” $$/SD 











Turbo C: The Art 
Program Design, 
of Advanced 
Optimization 
and Debugging 





by Stephen R. Davis 


Overflowing with example programs this book fully describes the 
techniques necessary to skillfully program, optimize and debug in Turbo 
C. Every topic and Turbo C feature discussed is fully demonstrated in 
Turbo C source code examples. Advanced topics such as pointers: 
direct screen I/O; inline statements in Turbo C; and how to intercept and 
redirect BIOS calls are all covered indepth. The author further 
demostrates these advanced topics by writing a RAM resident pop-up 
program in Turbo C. Learn about the differences between Unix C and 
Turbo C, about the transition from Turbo Pascal to Turbo C, and about 
the superset of K&R C features implemented in Turbo C and included in 
the proposed ANSI C standard. 
Book & Disk (MS-DOS) 
Book 


item #45-3 
item #38-0 


$39.95 
$24.95 


Small-Windows: 
A Library of 
Windowing 
Functions for the C 
Language 


..., . 
by James E. Hendrix 


Small-Windows is a complete windowing library for C. 
The package includes: 18 video functions written in 

assembly language, 7 menu functions that support both static and pop- 
up menus, 41 window functions to clean, frame, move, hide, show, scroll, 
push, and pop windows. Two test programs are provided as examples to 
show you how to use the library and the window, menu, and directory 
functions. Documentation and full C source code is included. Available 
for MS-DOS systems for the following compilers: Microsoft C Version 4.0, 
Small-C, Lattice C and Turbo C. Please specify compiler format. 


Manual & Disk (MS-DOS) item #35-6 $29.95 


Dr. Dobb’s 


Toolbook of C The Smalli-C Compiler 


and Small-C 
Handbook 





the Editors of 
Dr Dobb ’§ Journal of 
Software Tools 





by James E.Hendrix 


) This authoritative reference contains over 700 pages of the best C This compiler and handbook provide everything you need for learning 
: articles and source code from Dr Dobb’s Journal of Software Tools, how compilers are constructed, and for learning C at its most 
along with new material by C experts. You'll find hundreds of pages of fundamental level. You'll find a discussion of assembly language 
useful C source code, including a complete compiler, an assembler, and concepts and program translation tools, and learn how to generate a 
text-processing utilities. new version of the compiler. Full source code is included. The handbook 
Book Item #615-3 $29.95 and compiler on disk are available for both MS-DOS and CP/M systems. 


The handbook comes with an addendum for the MS-DOS version. Please 
specify format. 

, Book & Disk (MS-DOS) item #76-3 $42.90 

7 Book & Disk (CP/M) Item #67-4 $37.90 


| Small-Tools: Small-Mae: 
| Programs for Text An Assembler for 
Processing Small-c 





X 





by James E. Hendri 





James FE. Hendrix 


This package of programs performs specific, modular operations on This assembler features simplicity, portability, adaptability, and 

text files, including: editing; formatting; sorting; merging; listing; printing; educational value. The package includes: a simplified macro facility; C 
: searching; changing; transliterating; copying; concatenating; encrypting language expression operators; object file visibility; descriptive error 
} and decrypting; replacing spaces with tabs and tabs with spaces; messages; an externally defined instruction table. You get the macro 
: counting characters, words, or lines; and selecting printer fonts. Small- assembler, linkage editor, load-and-go loader, library manager, CPU 
Tools is supplied in source code form. With the Small-C Compiler, you configuration utility, and a utility to dump relocatable files. Documentation 
can select and adapt these tools to your own purposes. Documentation is included. For CP/M systems only. Please specify format. 
is also included. Available for MS-DOS or CP/M systems. Please specify Manual & Disk (CP/M) Item #77-1 $29.95 
format. | 
; 


Manual & Disk (MS-DOS or CP/M) Item#78-X $29.95 


5 Sa : 


To Order: Special Packages 


Return the postage-paid Order Card on the next page, or 
CALL TOLL FREE 800-533-4372 (In CA 800-356-2002) & ave T 5%, 


) Receive the € Chest book & disk, the Ture € book & disk, and the 
Small-Windows manual & disk, all for only $93.95! You save 15% 


C Chest/Turbo/Window Package item#168 $93.95 





Just Released! 


Maximize the Power 
of OS/2 











The Programmer’s 
© 
a oe oo © . re The Programmer’s Essential OS/2 Handbook will \et 
you harness the power of OS/2, without getting lost in its intri- 
cacies. This hands-on, working reference book is organized 
to guide you through the complex features of the new OS/2 
system. You'll even find detailed technical information that is 
not included in the official OS/2 documentation. 
Multiple indices and a web of cross-referencing provide easy 
Peceeest Beyyen ee access to all OS/2 topic areas. Equal support for Pascal and 
C programmers is provided. You'll find: 


¢ an overview of OS/2 architecture and vocabulary, includ- 
ing references to where the book handles each topic in 
depth 


¢ a look at the 80286 and a description of how the CPU 
processes data in real and protect mode 


* an overview Of linking, multiprogramming, file access, 
and device drivers 


¢in depth discussions of important OS/2 topics, including 
dynamic linking; the message facility; the screen group: 
keyboard, mouse, and screen input, output and monitors: 
the queue; the semaphore; the thread; the process; stor- 
age allocation; segment swapping; and IOCTL usage 


¢ detailed accounts of nearly 300 system calls, including 
DOS calls, keyboard calls, video calls, mouse calls, and 
device driver aides. 





The Programmer’s Essential OS/2 Handbook is a re- 
source no programmer developing in the OS/2 environment 
can afford to be without. 





by David E. Cortesi (PE/AT 5" 1.2 megabyte, "2 mepabyie) 


To Order: 


Return the postage-paid Order Card , or 
CALL TOLL FREE 800-533-4372 (In CA 800-356-2002) 
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Bring the 
Conveniences 


of UNIX To YOUR 





Full Source Code on Disk! 


On Command: 





by Allen Holub 


This book and ready-to-use program demonstrate how to write a Unix- 
like shell for MS-DOS, with techniques applicable to most other program- 
ming languages as well. The book and disk include a detailed description 
and working version of the Shell, complete C source code, a thorough 
discussion of low-level MS-DOS interfacing, and significant examples of 
C programming at the system level. 

Supported features include: read, aliases, history, redirection and pipes, 
Unix-like command syntax, MS-DOS-compatible prompt support, C-Shell- 
based shell scripts, and a Shell variable that expands to the contents of a 
file so a program can produce text that is used by Shell scripts. The Unix- 
like control flow includes: if/then/else; while; foreach; switch/case; break; 
continue. 

The ready-to-use program and all C source code are included on disk. 
For IBM PC and direct compatibles. 


Book & Disk (MS-DOS) Item #29-1 $39.95 


Sane 157 


Receive On Command, Util and NR together for only $85.95! 
You get all the convenience of Unix-like features and save 15%. 


Unix-like Features Package item #167 $85.95 








Writing a Unix- Like 


Software Tools ° 
FOR THE PROFESSIONAL PROGRAMMER za Won RS Semen ation 


of the Unix NROFF 
Werd Processor 


ee 
by Allen Holub 


NR is a text formatter that is written in C and compatible with UNIX’s 
NROFF. Complete source code is included in the INR package so that it 
can be easily customized to fit your needs. INR also includes an imple- 
mentation of the -ms (manuscript) macro package and an in-depth de- © 
scription of how -ms works. INIR does hyphenation and simple propor- 
tional spacing. It supports automatic table of contents and index 
generation, automatic footnotes and endnotes, italics, boldface, over- 
striking, underlining, and left and right margin adjustment. NIR also 
contains: 

e extensive macro and string capability 

e number registers in various formats, including Roman 

and Arabic numerals, both spelled out and in outline form 

e diversions and diversion traps (macros that are triggered 

automatically) 

e input and output line traps 
NR is easily configurable for most printers. Both the ready-to-use pro- 
gram and full source code are included. 
For PC compatibles. 


Manual & Disk (MS-DOS) Item #33-X $29.95 


THE PROFESSIOMAL PROGRAMMER 





by Allen Holub 


When used with the Shell, this collection of utility programs and sub- 
routines provides you with a fully functional subset of the Unix environ- 
ment. Many of the utilities may also be used independently. You'll find ex- 
ecutable versions of cat; cp; date; du; echo; grep; Is; mkdir; mv; p; 
pause; printevn; rm; rmdir; sub; and chmod. 

The \Util package includes complete source code on disk and all pro- 
grams (and most of the utility subroutines) are fully documented in a 
Unix-style manual. For IBM PC and direct compatibles. 


Manual & Disk (MS-DOS) Item #12-7 $29.95 


To Order: 


Return the postage-paid Order Card, or 
CALL TOLL FREE 800-533-4372 (In CA 800-356-2002) 
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size of their bounding rectangles. 
Figure 1, also below, shows some of 
the PICT images. Figure 2, page 100, 
shows the ICONs and ICN#s. I also 
removed the CDEF from the decom- 
pilation (more meaningless hex). It’s 
produced by compiling _ rect- 
CDEF Asm, as described later. 

Lightspeed C takes the resources 
in custom controls demo PROJ rsrc 
and binds them into the finished 
custom controls demo application. 
Other Mac development systems let 
you perform congruent conjunc- 
tions. 


Custom Controls Demo’s 
Resources 

BNDL 128—This BuNDLe resource 
connects the program to its Finder 
icon. 

CDEF 40—The Control Definition 
code. 

CNTLs 1 thru 21—CoNTroL specifi- 
cations for each of the program's 
main modal dialog's 21 custom con- 
trol items. 

CuCo 0—The application’s version 
data/signature/creator resource: a 
Pascal-type_ string providing its 
name, version, and date. 

DITL 1—Dlalog [Tem List for the 
program’s main modal dialog. 

DITL 210—DlIalog ITem List for the 


PICTs 50 and 51—see last month’s Figure 3, variation 5—rect: 0,0,57,61 


PICTs 60 and 61—-see last month’s Figure 3, variation 7—rect: 0,0,68,69 


PICT 70—see last month’s Figures 4 and 7, DITL item 7 


ee rect: 0,0,34,32 


PICT 80—see last month’s Figures 4 and 7, DITL item 8 


—rect: 0,3,196,116 


PICT 90—see last month’s Figures 4 and 7, DITL item 9 


ee rect:0,1 2,35,73 


PICTs 100 and 101—see last month's Figure 3, variation 9—+rect: 0,0,56,70 


PICTSs 170 and 171—see last month’s Figures 4 and 7, DITL item 17, and this 
month's Figure 2—rect: 0,0,187,85 


PICTSs 200 and 201—-see last month’s Figures 4 and 7, DITL item 20, and this 
month's Figure 2—rect: 0,0,24,24 


PICT 210—see last month’s Figure 2—rect: 1,14,168,290 





Table 1: Finding the PICTs, and their bounding rectangles, from custom 


controls demo 


ey Custom controls demo... 


Written and ©1987 by Stan Hrute. All rights reserved. 
Mo part of this application may be reproduced, in any 
form of by any means, without the express written 
permission of the author and copyright holder. 


Stan Hrute 


18617 Camp Creek Road 
Hornbrook, CA. S6BY+ 
(916) 475-3428 


PICT 171 
Rect: 0,0,187,85 


PICT 201 


MCi Mail: Stan Hrute 
Delphi: STANHRUTE 
Compuserve: 73137,.2121 


PICT 210 
Rect: 0,14, 166 230 


Rect: 00,2424 





Figure 1: Selected PICTs from custom controls demo 
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copyright button’s modal dialog. 
DLOG 1—DiaLOG template for the 
program's main modal dialog. 
DLOG 210—DiaLOG template for the 
copyright button’s modal dialog. 
FREF 128—File REFerence that 
hooks the program .up with its 
Finder icon. 

ICN# 128—The program’s Finder 
icon. 

ICONs 30, 110, 120, 121, 130, 140, 141, 
150, 160, and 161—ICONs used with 
various control items in the main 
modal dialog. Numbering conven- 
tion: the control’s item number in 
the dialog times 10, with 1 added for 
a content-change image. 

MENU 1—Menu template for the pro- 
gram’s menu. 

PICTs 50, 51, 60, 61, 70, 80, 90, 100, 
101, 170, 171, 200, and 201—PIC- 
Tures used with various control 
items in the main modal dialog. Num- 
bering convention: the control’s item 
number in the dialog times 10, with 
1 added for a content-change image. 
PICT 210—PICTure used with the 
copyright button’s modal dialog. 
STRs 20 and 40—STRings used for 
content changing with the modal 
dialog’s control items 2 and 4. 


CDEF Development Files 

As mentioned in last column, the 
CDEF is written in assembly lan- 
guage, using MDS 2.1. Figure 3, page 
100, shows the files involved in its 
development. rectCDEF.Asm and 
rectCDEFEqu.Txt are the critical 
files; the others are either MDS- 
specific or adjuncts to development. 
Here are brief descriptions: 


rectCDEF.Job—An MODS executive 
file used to control one iteration of 
the development cycle. After compil- 
ing the CDEF, it turns it into a code 
resource, puts the resource into sev- 
eral files, and ends up in custom 
controls demo, ready for testing. See 
Listing Two, page 65. 

rectCDEF Asm—Assembly-language 
source code for the CDEF. Entry 
point is at the beginning of the code. 
See Listing Three, page 66. 
rectCDEFEqu.Txt—Private __defini- 
tions for rectCDEF Asm. See Listing 
Four, page 83. 
rectCDEF.Link—Instructions for the 
MDS linker. Takes the Rel file pro- 
duced by assembling rectCDEF Asm 
and produces a standard Mac CODE 
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Quit Wasting Time! 


As a programmer, most of your time is spent writing and de- 
bugging source code, and documenting your work. A powerful, 
easy-to-use programmable text editor could be saving you 
HOURS of unnecessary effort. 


Only MULITI-EDIT has all these time-saving features: 


Fully automatic Windowing and Virtual Memory. 
Edit multiple files regardless of physical memory size. 
Easy cut-and-paste between files. 

View different parts of the same file. 


Powerful, EASY-TO-READ high-level macro language. 
Standard language syntax. 
Full access to ALL Editor functions. 
Automate repetitive tasks. 
Easy, automatic recording of keystrokes. 





Complete DOS Shell. 
Language-specific macros for ALL major languages. alae directory listing. 
pat ene Copy, Delete and Load multiple files with one command. 
Smart brace/parenthesis/block checking. Background file printing 
Template editing. ; é 
Supports C, Pascal, BASIC and Assembler. Regular expression search and translate. 


Condensed Mode display, for easy viewing of your 
program structure. 
Pop-up FULL-FUNCTION Programmer’s Calculator and 


Terrific word-processing features for all your 
documentation needs. 


Intelligent word-wrap. ASCII chart 
Automatic pagination. : 
Full print formatting with justification, bold type, and MOST IMPORTANT, 
underlining and centering. 4 ! 
Even a table of contents generator. pe BEST user ee on the market! 
+ Extensive context-sensitive help. 

esr sek tipi Ae i debe * Choice of full menu system or logical function key layout. 
Built-in MAKE capabilities. * Function keys are always labeled on screen (no guessing 
Run compiled program without leaving editor. required! ). 
Automatically allocates all available memory to compiler * Excellent online, interactive tutorial. 
or program. * Keyboard may be easily reconfigured and re-labeled. 


Users of Wordstar and Turbo Pascal’s Editor could be programming in a fraction of the time with these features. 
NO EDITOR ON THE MARKET TODAY HAS ALL THESE FEATURES, OR OFFERS YOU THIS MUCH POWER. 












AT A REASONABLE PRICE, EXCEPT 
B - COMPLETE 
u Tl ae iT Or Get our FULLY FUNCTIONAL DEMO 
@ Copy for only $10! 


VERSION 2.0 


Requires IBM/PC/XT/AT/PS2 or full compatible, 256K RAM, PC/MS-DOS 
2.0 or later-Multi-Edit and American Cybernetics are trademarks of American 









Get our FULLY FUNCTIONAL DEMO Copy for only $10! 


Cybernetics. BRIEF is a trademark of Underware, Inc. Norton Editor is a To Order, Call 24 hours a day: American Cybernetics 
trademark of Peter Norton Computing, Inc. Vedit is a registered trademark of 1-800-221-9280 Ext. 951 138 Madrid Plaza 
CompuView Products Inc. Copyright 1987 by American Cybernetics. in Arizona: 1-602-890-1166 Mesa, AZ 85201 


Credit Card and COD orders accepted 
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resource. See Listing Five, page 83. 
rectCDEF.RO—Instructions for the 
MDS resource compiler. Takes the 
standard CODE resource produced 
by the linker and turns it into a 
CDEF. See Listing Six, page 84. 
rectCDEF.R1i—Instructions for the 
MDS resource compiler. Takes the 





WwOooeY 


ICON 110 








od 
— 
= 
Bemcenenxarll 


ICON 130 ICON 140 





rectCDEF.ASM 





\K 
rectCDEF Re 
= 


CDEF produced via rectCDEF.RO 
and adds it to custom controls 
demo. See Listing Seven, page 84. 
rectCDEF.R2—Instructions for the 
MDS resource compiler. Takes the 
CDEF produced via rectCDEF.RO 
and adds it to custom controls 
demo PROJrsrc. See Listing Eight, 
page 84. 

rectCDEF.Rel—The Rel file produced 
by assembling  rectCDEFAsm. 







| | oe 
a LS 


ICON 150 











ICN# 128 





rong 
Oot 


rectCDEF .Rel 


es be 
GC ‘ca 
“ES custom toatrals demo . & 


rectCDEF. Rerc 


Figure 3: The rectCDEF files 
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custom controls demo PROJ-rsrc 

















' Grundy of cybernetics. 








rectCDEF—tThe file produced by link- 
ing rectCDEF.Rel under the control 
of rectCDEF.Link. 
rectCDEF.Rsrc—The file produced 
by the MDS resource compiler that 
contains the CDEF resource. 
custom controls demo—My applica- 
tion, to which the MDS resource 
compiler adds the CDEF for easy 
testing during CDEF development. 
custom controls demo PROJ.rsrc— 
My application’s resources, to which 
the MDS resource compiler adds the 
CDEF. 


CDEF Refresher 
A C function prototype for a CDEF 
looks like this: 


pascal long someCDEF ( int varCode, 
ControlHandle theControl, int mes- 
sage, long param ) ; 


varCode indicates which of the 
CDEF's variations to use; theControl 
gives you a handle to the calling 
control's control record; and mes- 
sage tells the CDEF what to do. 
There are nine possible messages— 
see Inside Macintosh and/or the mes- 
sage jump table in the source code. 
Finally, param is 4 byte of data that 
vary according to the message 
passed to the function. The mean- 
ing of the function result also varies 
with the message; the default return 
value is 0. 

The pascal keyword in the proto- 
type indicates that the function is 
called with Pascal calling con- 
ventions. In rectCDEFAsm, I use 
LINK/UNLK to create space for some 
local variables. Figure 4, page 101, 
shows how the stack looks after the 
CDEF is called and the LINK A6 
command's been given. 


The Clean Nut Can’t Shut Up 

As I never tire of pointing out: good 
Mac programming has to play by 
the rules. Keep it clean, and your 
programs will run now and in the 
future. What entaileth clean? Deal 
with error codes. Lock down heap 
objects only when you must, and let 
them float whenever you can. 


| Assume nothing. Steer clear of low 


memory. Follow Inside Mac and 

Apple's Mac Tech Notes religiously. 

Etc., etc; etc. 
Gawd, I sound 


like the Ms. 


But, hey, 
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cleanliness works. Clean Mac pro- 
grams I wrote three years ago func- 
tion on Mac IIs under MultiFinder. 

Take a look at the rectCDEF code, 
for example. The control that’s call- 
ing the CDEF gets its control record 
locked down during any call to the 
CDEF (see the CDEF's entry area). 
The same with the control’s auxil- 
iary data block (also in the CDEF's 
entry area). Both of these data ob- 
jects are released at the end of the 
CDEF call. Calls to the resource and 
memory managers (in do/nitCntl) are 
carefully checked for success/failure, 
and the program tries to respond 
reasonably to the results (see do- 
InitCntl and doDispCntl). 

This is a 680x0 we've got, with all 
those lovely registers waiting to 
serve. So pack ’em up. That's what I 
try to do in the CDEF. Here's the 
scoop: Three address registers are 
taken up right off the bat. A7 points 
to the stack, A6 points to a stack 
frame, and A5 fingers application 
and Quickdraw globals. Then, I use 
A2 to point to the control’s record 
and A3 to point to its auxiliary data 
block. That leaves A4 free for tempo- 
rary usage and AO and Ai for even 
more temporary usage. That's be- 
cause ROM/OS calls generally trash 
AO and A1. 

Data registers next: I use D3 to 
hold the function parameter param. 
D4 holds flags that let me quickly 
scoot around the code based on 
which of the 16 CDEF variations is 
in effect. That leaves D5, D6, and D7 
free for temporary usage and DO, D1, 
and D2 for even more temporary 
usage. Again, that’s because ROM/OS 
calls can trash DO, D1, and D2. 

On entry to the CDEF, I’ build a 
stack frame, save registers that I'll 
use, grab some parameters, grab a 
set of variation flags, set a default 
function result, lock the control 
record down, point to any auxiliary 
data block and lock it down (if it 
exists), then jump to a specific rou- 
tine based on the function's mes- 
sage parameter. 

Returning from that specific rou- 
tine, I make a somewhat symmetric 
exit: unlock any auxiliary data block, 
unlock the control record, restore 
saved registers, remove the stack 
frame, and jump on back to the 
CDEF’s caller. 

The CDEF handles 16 control vari- 
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ations. I use an 8-bit flag to signal 
eight qualities of a given control vari- 
ation. This simplifies the rest of the 
CDEF function’s control logic. Take 
a look at varFlagTable for details. 


20(A6) 
18(A6) 


14(A6) 
12(A6) 


8(AG) 


4(A6) 








-autoBytes(A6) 


fon v2.0 = () Copyright 1967,1888 by BYP - Intelligent Solutions, Tac. 


... for Programmers: 


e Your documentation is available 
ANYWHERE, ANY TIME. 

e Access, display and print your 
documentation by name or by 
user-defined categorization trees. 

® Your choice -- pull-down menus 
or intuitive accelerator keys. 

® Powerful print & copy functions. 


... for Project Managers: 


e Programmers produce more and 
better documentation. 

® Reduced function redundancy. 

® Greater programmer productivity. 


Ny — Jentelligent 


Ne" olutions, inc. 








P.O. Box 20478 








Handling Controls 

doInitCntl takes care of any special 
initialization needs. For this CDEF, I 
need an auxiliary data block to hold 
handles to variant-specific resources. 


previous stack contents 


function result 


theContro! 


message 


previous A6 contents 
(A6) 


(SP) autoBytes worth of local variables 


low memory 





Figure 4: The state of the stack upon entry to rectCDEFProc, just after 


the LINK instruction 


Documentation 
isa PAIN! 


..- Without DocuMotion™ 


We’ve found that well indexed and easily accessed documentation 
is a powerful tool. Now you can simply pop up DocuMotion to 
access, display and print your documentation or guide reference 
libraries. DocuMotion builds cross indexed document libraries 
from documentation contained in your source code or any text file. 
Version 3 adds great features like: folding documents, cross- 
referencing, 10 book marks, and a context-sensitive help interface. 


DocuMotion is PAINLESS 
[IT’S DOWN-RIGHT FUN! 


... for the PC: 


e Runs memory resident or non- 
resident on any IBM PC/XT/AT 
or compatible. 

© Compatible with all popular 
memory resident programs. 

® LAN compatible. 


DocuMotion is for YOU: 
Call NOW 1-612-884-5860 
Developer’s System $159.95 


Coming Soon: Reference Guides for 
your favorite tools...CALL. 


We need your expertise for reference guides. 
Any Topic. Liberal royalties... CALL 


Bloomington, MN. 55420-0478 
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So doInitCntl first tries to get a block. 
If it succeeds, it then looks to see 
what resources are needed, tries to 
load them in, and then stores the 
resulting handles in the auxiliary 
data block. 

Note the code’s provisions for fail- 
ure. No memory available for the 
auxiliary data block? You jump 
nimbly out of the initialization, leav- 
ing a tell-tale NIL handle behind in 
the control record. Resources can't 
be loaded? Again, NIL handles are 
stored to tell the tale. Other routines 
in the CDEF check for all these NIL 
handles and and react appropriately. 

doDispCnitl takes care of any spe- 
cial control disposal operations. In 
this case, I need to release any vari- 
ant-specific resources that were 
loaded during initialization, then get 
rid of any auxiliary data block. The 
code's pretty straightforward. Note 
how I check for, and dance around, 
any NIL pointers/handles. 

doDrawCntl is invoked when the 
CDEF'’s asked to draw the control. It 





first saves grafport features it may 
change. Then it cases out on the 
type of outline the control needs: 
shadowed, simple, or none. After 
drawing the outline, it sets the 
grafport’s clipping region to the con- 
trol’s interior. Then there’s another 
case-out, this time to draw the 


Interior clip regions 
make sure that 
button contents 

don’t spill out 
of bounds. 


button’s interior, which can contain 
text, icon, or a picture. After the 
interior’s drawn, the routine restores 
the saved grafport features and 
ends. 























Outlines and Interior Clip 
Regions 

It's fairly simple stuff, really. 
rectCDEF supports two styles of out- 
lining: shadowed and simple. doS- 
hadOutline draws shadowed out- 
lines. First it draws two shadow 
lines, then a rectangle. doSimpOut- 
line draws simple outlines by draw- 
ing a rectangle. 

Interior clip regions make sure 
that button contents don’t spill out 
of bounds. For outlined buttons, you 
just take a rectangle slightly inset 
from the button’s bounding rectan- 
gle. Naked buttons use the bound- 
ing rectangle. 


Drawing Button Interiors 
doTextinterior draws text button in- 
teriors. It starts by figuring out 
which font the button’s text will get 
drawn in and sets the grafport ac- 
cordingly. Then it uses the font in- 
formation to figure out vertical posi- 
tioning for the text. 

Next, the routine gets a pointer to 
the text string it'll draw. This can be 
the control's title or, in the case of a 
content-changing button, a STR re- 
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New Titles for the 


Computer Professional 


from Springer-Verlag 








New 


Software Engineering in C 
P.A. Darnell and P.E. Margolis 


“. . . Software Engineering in C is much 
more than how to write legal C, providing 


pointers on how to write clear efficient C and 


what pitfalls to watch out for on the way.” 
— Bob Scheulen 

Senior Software Engineer, Microsoft® 
The book includes C’s more advanced fea- 
tures, a chapter on software engineering, a 
listing of differences between the ANSI and 


K&R Standards, and a C Interpreter Listing. 


1988/612 pp/62 illus/59 tables/Paper $29.95 
ISBN 0-387-96574-2 


(Springer Books on Professional Computing) 








Springer-Verlag 
New York Berlin Heidelberg Vienna 
London Paris Tokyo 
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New 


An Introduction to TCP/IP 
J. Davidson 


This book describes TCP/IP, the most impor- 
tant emerging internet protocol suite in the 
computer networking field. Material is pre- 
sented according to the Seven Layers of the 
ISO Reference Model, each Layer of which 
provides a specified level of networking serv- 
ice. The book should be a valuable source of 
information for those interested in local or 
wide-area computer networking projects. 


1988/100 pp./30 illus./Softcover $24.95 
ISBN 0-387-9665 1 -X 


New 


The Unix System Guidebook 
Second Edition 
P.P. Silvester 


This book presents the Unix system for the 
beginning user. While the emphasis is on 
System V, the book also makes note of 
Berkeley 4.2 BSD and Seventh Edition Unix. 
Major features of this second edition include 
in-depth coverage of editing with vi and for- 
matting text with nroff, an increased discus- 
sion of Shell programming, and a section on 
using Writer’s Workbench. 

1988/325 pp/15 illus./Softcover $35 (tent.) 
ISBN 0-387-96489-4 

(Springer Books on Professional Computing) 
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Taming the Tiger 
Software Engineering and Software 
Economics 


L.S. Levy of AT&T Bell Laboratories 


The book presents a new approach to soft- 
ware development based on the analytical 
techniques of managerial economics. Models 
presented in the book show how to apportion 
development costs among different phases of 
the development cycle. The book should be 
of special interest to software engineers and 
managers of software development. 
1987/248 pp/9 illus/Softcover $25.00 

ISBN 0-387-96468- 1 

(Springer Books on Professional Computing) 








To order by credit card, please call our toll- 
free number: 1-800-526-7254 (in NJ call 
201-348-4033). To pay by check (in- ide 
$2.50 for postage and handling; NY, NJ, and 
CA residents please add sales tax) or for 
more information, write to: 


Springer-Verlag New York, Inc. 
Computer Science Promotion 
175 Fifth Avenue 

New York, N.Y. 10010 
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line after line of time-consuming code. Most DBMS’ and 4GL’s give 
programming power. But when it comes to serious applica- 
tions, they keep you bolted to your seat writing mountains of tedious 


you some 


code. And rewriting it all over again with every design change. 


Imagine how much faster you'd be if you a oould replace the painful 


out 


coding phase with an innovative visual technology which takes only a 
fraction of the time: Introducing Magic PC—the revolutionary Visual 


Database Language from Aker Corporation: 


e High-Speed Programming: 


With Magic PC’s visual design language you quickly describe your 
programs in non-procedural Execution Tables. They contain compact 
programming operations which are executed by Magic PC’s runtime 
engine. You fill-in the tables using a visual interface driven by windows 
and point-and-shoot menus. One table with 50 operations eliminates 
writing more than 500 traditional lines of code. Yet with Magic PC you 
don’t sacrifice any power or flexibility. 


9|/Upd Field 
10}Write Fite 
1i]Read File 

12]Scan File 
13}User Fxuit 
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With a powerful set of high-level non-procedural operations you 
program at only a fraction of the time. 


e¢ Maximum Power AND Simplicity: 

With Magic PC, you can generate robust DBMS applications includ- 
ing screens, windows, menus, reports, forms, import/export, and much 
more! Plus, Magic PC has one of the friendliest user interfaces you've 
ever seen. Using Magic PC you can look-up and transfer data through 
a powerful Zoom Window system. Magic PC even lets you perform 
command-free queries. 


e Btrieve Performance: 

Magic PC incorporates Btrieve, the high-performance file manager 
from SoftCraft. This gives you exceptional access speed, extended data 
dictionary capabilities, and automatic file recovery! 


e Virtually Maintenance-Free: 

With Magic PC you can modify your application design “on the fly’ 
without any manual maintenance. Magic PC automatically updates 
your programs and data files on-line! This also makes Magic PC an 
ideal tool for prototyping complete applications in hours instead of days. 


e FREE Networking: 

Magic PC comes complete with LAN features. Develop multi- user 
applications for your LAN with Magic’s file and record- locking 
security levels. 


e Stand-Along Runtime: 
Distribute your applications and protect your design with Magic PC’s 
low cost runtime engine. 


e All For Only $199: 

Best of all, Magic PC is an unbeatable bargain. For a limited 
time, Magic PC’s price has been reduced to only $199! Yes, this is 
the same Magic PC that normally lists for $695! And Magic PC 
eliminates the need for a separate DBMS, compiler, or applica- 
tion generator. It comes complete with all the tools you need 
to develop your own database applications instantly. 
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‘‘Magic PC’s data base engine delivers powerful 


applications in a fraction of the time. . . there is 


truly no competitive product.’ 
Victor Wright — PC Tech Journal 


Order Ho: $99 Customer No 99999 
Order Date 99/99/99 Address 


GED EE | 


Item List 


Description 


Order Sum 
Discount 
Sub-Total 
Sales Taz 
In Stock -999.999 
Total Orders -999,999 
Avail to Sell. -999,999 


Pop-up Zoom Windows run multiple programs per screen — with 
point-and-shoot data transfer between windows! 


e $199 — With A Money-Back Guarantee! 


For a limited time, you can get Magic PC for only $199. 
And even at this low price, Magic PC is risk-free. If you’re not 
completely satisfied, simply return it within 30 days and we'll 
buy it back (less $19.95 restocking fee). And if you’d like a 
preview, Magic PC’s Tutorial Demo is available for just $19.95. 

But you’d better hurry — Magic PC’s special $199 price 
won't last long! 


e Join The Magic PC Revolution 
To unleash your DBMS design power, order your $199 copy of 
Magic PC right now by calling toll-free or returning the coupon below. 


ORDER NOW: CALL 


(800) 345-MAGIC 
In CA (714) 250-1718 


MAGIC PC 


by. qe 
ain = 








Yes! I want 
to generate powerful 
applications much faster! 
C) Rush me my copy of Magic PC at the special promotional price 
of $199 (add $10 P&H, and tax in CA International orders add 
$30). I understand I can return Magic PC for a refund within 30 
... days, if I’m not completely satisfied. * 
a» C) Rush me a copy of Magic PC Tutorial Demo at $19.95 (add $5 
| P&H, and tax in CA Intemational orders add $15). 
Fe company —____ Phone 
7 Street Address (no POB) 











City secs Ss Maa State Zip 

CZ Check enclosed Charge to my: oo taco tO Soa 
Maia NO, mc i i et a cee a a ee ee 
Acct. Name Bap. Date: co / ane 
Signature =] 
Retum to: Aker Corp., 18007 Skypark Cir B2, Irvine, CA 92714 =I 


System requirements: IBM PC, XT, AT, PS/2 or 100% compatible with 512K RAM, hard disk and DOS 
2.0 or later. 5'4” format, not copy protected. Dealer pricing available. * Return policy valid in US only. 
Aker, Magic PC, The Visual Database Language are trademarks of Aker Corporation. All other 
trademarks acknowledged © Copyright 1987, Aker Corp. 


























TO THE MACS 
(continued from page 102) 


source. If it’s a STR resource, the 
resource gets locked down. The rou- 
tine uses the text string to figure out 
horizontal positioning. Now that the 
vertical and horizontal positions are 
known, doTextInterior moves the 
grafport’s drawing pen into place to 
start drawing the string. 

Depending on the button’s type 
and state, the interior is painted 
white or black. Based on the same 
information, the routine draws the 
text string in black or white. If a STR 
resource supplied the text, it’s now 
unlocked. And, if the button’s in an 
inactive state, black text gets turned 
to gray. The routine restores the 
grafport and exits. 

doPictInterior draws _ picture 
button interiors. First it figures out 
the PICT resource to use, then it 
locks the PICT down. It uses the 
PICT’s height and width to set up a 
destination rectangle that'll center 
the picture in the button’s interior. 
If the picture’s too big, the destina- 
tion rectangle is set so its upper-left 











corner matches the button interior’s 
upper-left corner. Then the routine 
erases the button’s interior and 
draws the PICT, and the PICT gets 
unlocked. Finally, a separate rou- 
tine, interiorAdjust, is called to deal 
with any necessary image inverting 
or graying out. 

Very similarly, dolconInterior 
draws iconic button interiors. It uses 
the standard height and width of an 
icon to set up a destination rectan- 
gle that'll center the icon in the 
button's interior. If the icon’s too 
big, the destination rectangle is set 
so its upper-left corner matches the 
button interior’s upper-left corner. 
Then the routine erases the button’s 
interior and draws the icon. Finally, 
interiorAdjust is called to deal with 
any necessary image inverting or gray- 
ing out. 


Procedural wrap up 

doTestCntl tests a point to see if it’s 
contained within an active control. 
If it is, the routine sets the CDEF’s 
function result to the control’s part 
number. If the point isn’t in the 
control, or if the control’s inactive, 











the routine sets an appropriate 
result code. 

Because my controls are rectangu- 
lar, the containment test is simple: 
just call on the Mac’s PtInRect func- 
tion, which checks for a point’s con- 
tainment within a rectangle. 

DoCalcCCntl is deliciously trivial. 
Somebody wants the control de- 
scribed as a region? You just send 
the control's rectangle to the Mac’s 
RectRgn procedure, which takes a 
rectangle and produces a correspond- 
ing region description. 

There are four messages to the 
CDEF that you ignore, relying in- 
stead on the Mac’s default behav- 
iors. So doPosCntl, doThumbCntl, 
doDragCntl, and doAutoTrack are 
just stubs. 


Availability 

All the source code for articles in 
this issue is available on a single 
disk. To order, send $14.95 to Dr. 
Dobb’s Journal, 501 Galveston Dr., 
Redwood City, CA 94063, or call (415) 
366-3600, ext. 216. Please specify the 
issue number and format (MS-DOS, 
Macintosh, Kaypro). 





C Programmers: Combine C and COMMON LISP 





to Increase the Power of Your Software 





TransLISP PLUS .- 
























Simple. 


Add LISP features to your software without mak- 
ing it a full time job. The TransLISP PLUS tutorial, 
on-line help, and 30 sample programs with 
commented source make it easy. 


Practical. 


Start by modifying the LISP sample programs 
and including them in a system you wrote in C. 
Yes, in C! TransLISP PLUS includes a C Language 
Interface that lets you integrate your Microsoft C 
code and libraries with all or portions of our LISP 
interpreter. 

Use TransLISP PLUS to add natural or command 
language features to replace menus... or to flexibly 
manage related but disparate information. Code 
from C libraries provided by other vendors can be 
integrated into your program to perform tasks not 
normally part of LISP. 
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Source™ 541-D Main St., Suite 412, So. Weymouth, MA 02190 


Thorough. 


TransLISP PLUS took over 400 primitives from 
the most widely used and respected LISP standard, 
COMMON LISP, and made it available on IBM 
PCs, XTs, ATs, and virtually every other MSDOS 
machine. So now you can work with anything from 
a $700 PC to a $7000 PC. 

The utilities toolbox is included at no charge with 
a built-in editor, pretty printer, cross reference, 
and additional debugging tools. 

An optional Runtime encrypts your source code 


so that you can distribute your applications safely. 
You pay no royalties. 
Requires MSDOS 2.0+, 320K RAM, and a 360K floppy. 


MONEYBACK GUARANTEE 


Try TransLISP PLUS ($195) for 30 days — if not 
satisfied get a full product refund. The Optional 

Runtime is available for $150. Or start by learning 
LISP with TransLISP ($95) then upgrade to PLUS 


for $158. 
Call (800) 255-4659 


In MA (617) 331-0800 
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Revision Control System 


With MKS RCS running under DOS, programmers, systems adminis- 
trators, project managers and librarians can efficiently control and 
record the revisions of text files such as programs, documentation, 
graphs, papers, form letters, and so on. This software package: 

¢ resolves access conflicts — for example, it prevents two programmers 
or authors from making simultaneous changes to a file; 

* maintains a complete history of changes, including date and time of 
change, author, and reason for the change; 

¢ allows retrieval of any version of the file, by date, release number, or a 
user-assigned name; 

* runs quickly because only the most recent version of a file is stored 
— non-current versions are stored as difference-files to minimize 
storage requirements; 

¢ allows divergent versions to branch from the main family of versions 
— these might be test versions of programs, or customized versions 
of documents; 

Programs included in the package: 


¢ ci — check in RCS revisions ¢ rcsmerge — merge RCS revisions 
¢ co — check out RCS revisions ¢ rlog — display log messages 
¢ ident — display RCS identification about RCS files 

information ¢ diff — show minimal file 
* merge — three-way file merge differences 
¢ rcs — change RCS file attributes ¢ diff3 — show differences among 
¢ rcsclean — clean up work files three files 


¢ rcsdiff — compare RCS revisions 


The entire system for $189. 
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Also available: | 

The MKS Toolkit: over 110 UNIX-based tools for DOS including the Korn Shell, Vi, and AWK, 
complete with nearly 400 pages of documentation and tutorials. The complete package: $139. 
MKS Vi: The UNIX screen editor running under DOS at lightning fast speeds — it’s tuned for the 
PC. Comes with Tutorial and Reference Manual for $75. 

AWK: The 4th generation language written for DOS and fully compatible with the latest Bell 
Labs’ specs: $75. AWK and The AWK Programming Language by Aho, Weinberger, and 
Kernighan: $89. 





Mortice Kern Systems Inc., 
35 King Street North, Waterloo, Ontario, Canada N2J 2W9 (519) 884-2251 


BIX User Name: mks CompuServe User ID: 73260, 1043 


MKS software runs under MS-DOS 2.0 or later. Not copy protected. Prices quoted in US funds. VISA, 
MASTERCARD, American Express, uucp, and purchase orders (over $200) are accepted. Overseas orders 
please add $15 for postage and handling. MKS is a registered trademark of Mortice Kern Systems Inc. UNIX is 
a trademark of AT&T Bell Labs. MS-DOS is a trademark of Microsoft Corp. 
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RAIMA & Programmer’s Paradise offer you the best value on the tools you need. 





1. It’s writtenin C. 


Clearly the growing language of choice for applications that 
are fast, portable and efficient. 


2. It's fast — almost 3 times faster than a leading competitor. 
Fast access that comes from the unique combination of the 
B-tree indexing method and the “‘network”’ or direct “‘set”’ 
relationships between records. 


3. It’s flexible. 

Because of db__VISTA’s combination of access methods, 
you Can program to your application needs with ultimate 
design flexibility. Use db_VISTA as an ISAM file manager 
or to design database applications. You decide how to opti- 
mize run-time performance. No other tool gives you this 
flexibility without sacrificing performance. 


4. It's portable. 


db_VISTA operates on most popular computers and operat- 
ing systems like UNIX, MS-DOS and VMS. You can write 
applications for micros, minis, or even mainframes. 


5. Complete Source Code available. 

The entire C Source Code is available so you can optimize 
performance or port to new environments yourself. 

6. It uses space efficiently. 

db_VISTA lets you precisely define relationships to 


i 





; 
minimize redundant data. It is non-RAM resident; only those db_VISTA or db__QUERY List ' 
functions necessary for operation become part of the run- rae Nae wiSnuece he 
time program. 3 Multi-user $495 : 
7. Royalty free run-time. Multi-user w/Source $990 
Whether you’re developing applications for yourself or for Order Now ‘ 
thousands, you pay for db_VISTA or db__QUERY only db_VISTA from Raima Corporation, put it to work 1 
once. If you currently pay royalties to someone else for in your application program. 


your hard work, isn’t it time you switched to royalty-free 


db__VISTA? 


8. SQL-based db_QUERY ~ 


Add Raima’s new C-linkable, SQL-based, ad hoc query and 
report-writing companion product to provide a simple rela- 
tional view of your db_VISTA applications. 


9. Free tech support. 


60 days of free technical and application development sup- 
port for every Raima product. 


10. Upward database compatibility 
Start out with file management in a single-user PC environ- 


ment —then move up to a multi-user LAN or a VAX A Division of Hudson Technologies, Inc. 
database application with millions of records. 42 River Street, Tarrytown, NY 10591 
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TURBO PASCAL 100 69 
TURBO PASCAL DEV.LIB. 395 =. 289 
BORLAND ADD-ONS CALL CALL 





Programmer’s Paradise Gives You Superb Selection, 
. Personal Service and Unbeatable Prices! 


Welcome to Paradise. The microcomputer software source that caters to your programming needs. 


Discover the Many Advantages of Paradise... 
TURBO PASCAL ADD-ONS 























| & eee price guaranteed e Huge inventory, immediate shipment @ Special orders ASCH TURBO GHOST WRITER 
| 2 "i i NEW 99 89 
} atest versions ® Knowledgeable sales staff @ 30-day money-back guarantee (COMPLETE A 
° ° ’ : L NEW 99 85 
Over 500 brand-name products in stock —if you don’t see it, call! DOS/BIOS & MOUSE TOOLS 75 68 
METRABYTE DATA ACQ. TOOLS 100 = 89 
SCREEN SCULPTOR 125 95 
SYSTEM BUILDER 150 129 
IMPEX 100 89 
1 REPORT BUILDER 130 115 
LIST OURS LIST OURS LISTOURS 1-DEBUGPLUS 60 49 
386 SOFTWARE C INTERPRETERS PC/EDT 250 229 TURBO.ASM 99 69 
ADVANTAGE 386 C OR PASCAL 895 829 C-TERP 298 229 PIEDITOR SPECIAL 195 155 | TURBO ASYNCH PLUS 129 99 
DESQVIEW NEW 130 109 INSTANT C 495 379 PMATE 195 115 | TURBOGEOMETRYLIBRARY NEW 100 89 
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ASSEMBLERS/LINKERS MULTI-C 149 135 DRVISTAORDRQUERY SPECIAL 195 159 | MSWINDOWSDEVELOPMENTKIT 500 319 
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PLINK86PLUS 495 279 | TURBOC TOOLS 129 99 PHACTMANAGER 249 «219 VC SCREEN 99 79 
RELMS, UNIWARE X-ASMS CALL CALL XQL 795 599 VIEWMANAGER 275 «199 
COBOL WINDOWS FOR DATA 295 239 
BASIC E-Z PAGE 295 259 FORTRANCOMPILERS W/SOURCE NEW 590 CALL 
: DB/LIB 139 119 MICRO FOCUS LAHEY FORTRANS77L SPECIAL 695 CALL eRe 
FINALLY! 99 89 COBOL/2 900 729 LAHEY PERSONAL FORTRAN 77 95 89 a : 
FLASH-UP 89 ~=«79 COBOL/2 TLSET NEW 900 729 MICROSOFT FORTRAN 450 285 
MACH 2 75 459 -CICS 1500 CALL RM/FORTRAN 595 479 
MS QUICKBASIC SPECIAL 99 65 LEVEL II COBOL 349-279 
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COLUMNS 


et's face it, when IBM selected 
Line 8088 as the engine for its 
first-generation PC, memory-seg- 
mented architecture officially 
became a bad idea whose time had 
come. Three-and-a-half generations 
of Intel chips later, we're still stuck 
with it, and there’s no relief in sight. 
Credit for all the remarkable things 
done on PCs goes not to the archi- 
tecture but to those with the ingenu- 
ity to find ways around the flaw in 
its addressing scheme: no single 
hunk of memory in a PC can be 
bigger than 64K. 

Compilers for the PC have dealt 
poorly with the problem. You can 
have multiple code segments and in 
some cases multiple data segments, 
but the 64K limit still applies to any 
single extent. Probably someone will 
write to tell me that the latest re- 
lease of Googlephonic Snobol or 
some such has made segmentation 
transparent, but I’m talking about 
the mainstream languages from the 
likes of Microsoft and Borland. They 
deal with memory segmentation by 
not dealing with it in any graceful 
fashion. 

The solution is, of course, to keep 
all objects (code units, global vari- 
able sets, arrays, and so on) smaller 
than 64K. This is usually a workable 
solution because most objects are 
inherently smaller than the magic 
number. In some cases, though, it’s 
simply not possible to remain within 
this arbitrary limit. Nobody gets hit 
harder in that regard than scientists 
and engineers, who routinely work 
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with extremely large numeric arrays. 

Many have tried the PC and found 
segmentation an insuperable barrier, 
even though their data would, given 
a decent addressing scheme, fit 
within the free memory of the aver- 
age PC. This article is for them and 
for anyone else faced with the unsa- 
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vory task of attempting to process 
arrays of several thousand elements. 


Memory Segmentation 
Memory segmentation works like 
this: It takes two elements to ex- 
press a complete address. The first 
element is a base, or point of refer- 
ence, and the second is an offset 
from the base. In the Intel chips, the 
segment registers (CS, DS, and ES) 
contain base addresses that remain 
relatively fixed so that the offsets of 
variables, entry points, and so on 
can be reliably measured from them. 

A segment address is actually the 
upper four digits of a five-digit hex 
number. Therefore, each increment 
of the segment represents a 16-byte 
jump in real memory. In the endless 
quest for quaint terminology, some- 
one has dubbed these 16-byte hunks 
“paragraphs.” A segment always 
begins at a paragraph boundary, 
which is a multiple of 16 bytes. 

The offset is another four-digit hex 
value that measures a distance in 
bytes toward the top of memory, 
using the segment as the reference 
point. Four hex digits, of course, can 
represent any of 64K values. Conse- 
quently, any addressing range in the 
PC is constrained to 64K from a 
paragraph boundary. 

The CS register contains the base 
address for a code segment. When a 
program takes a long jump (or far 
call), the CS register changes to the 
base paragraph of the new code seg- 
ment. A far return reinstates the old 
CS so that execution resumes in the 
original code space. Thus a program 
can have multiple code segments, 
each of up to 64K. 








STRUCTURED PROGRAMMING 


The DS (data segment) register is 
less flexible. Compilers usually en- 
force a stable DS throughout pro- 
gram execution so that globals are 
universally accessible, meaning that 
the total size of all globals cannot 
exceed 64K, lest they be beyond the 
range of the offset. 

Auto variables—those allocated as 
locals within subprograms or passed 
as parameters—are even more con- 
strained. They're allocated on the 
stack—another 64K-max structure— 
so that space is limited to 64K less 
the stack space already occupied by 
other stuff. 

So what's a body to do with a 
huge hunk of data? There are a 
couple of alternatives. One is to 
build and process array images on 
disk. That’s an ugly way out. You'd 
better start a big matrix multiplica- 
tion just before a long weekend. An- 
other option, which I'll explore here, 
is using the heap. 

Purists may quibble, but the heap 
is essentially all the memory that’s 
left after any software currently in 
memory has staked its claims. 
Unless specifically set up otherwise, 
COM and .EXE programs consider 
the whole of uncommitted memory 
as their heap space. Given a moder- 
ately sized program and a couple of 
memory-resident utilities, a 640K ma- 
chine can usually yield a heap of 
about 450K to 500K. That’s a re- 
pectable amount of space: a quarter 
of a million integers, or upward of 
60,000 to 80,000 reals depending on 
precision. The trick is to use it effec- 
tively. 


What Can You Put into 64K? 
Programming strategies for manag- 
ing huge arrays inevitably involve 
some pencil sharpening. Let's first 
consider how much data can fit 
inside a 64K node allocated on the 
heap. 

Compilers typically claim a few 
bytes of memory for record keeping. 
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C-Worthy Interface Library helps you smoothly pull together all aspects of an excellent Human Interface. 


C Programmers: Wrap an Exciting, 
Bullet-Proof Interface Around 
Your Code Quickly. 


Introducing... 
C-Worthy® Interface Library 


The only human interface package 
you need. That’s what our customers 
are telling us. One early adopter, 
Novell, Inc. uses it exclusively in the 
development of their NetWare® 
Utilities, which reach over 500,000 
users. You see, C-Worthy Interface 
Library is the only library available to 
handle every aspect of your program’s 
human interface, all in one package. 
Now your programs will have a 
consistent look and feel. You no longer 
have to integrate pieces of libraries 
from different manufacturers. 

As important as you know users are, 
you often don’t have the time to heavily 
invest in writing routine code. And 
that’s OK, because with over 400 tight, 
ready-to-use functions, C-Worthy 
Interface Library takes care of the 
tedium and lets you spend your time 
doing what you enjoy. Concentrate on 
the heart of your application — features 
that make it unique, special. Let 
C-Worthy Interface Library do your: 

e Menus 

e Error Handling 

e DOS Interface 

e Context Sensitive Help 
e Screens, Windows 

e Forms, Data Input (optional) 


You control color, size, border, 
location, etc. And if there’s anything 
you want to change, you can. Source is 
available to provide you with the 
flexibility you need. And you can 
distribute your applications freely, with 
no royalties. 


C-Worthy Interface Library requires hard disk media with 256K 
RAM. MSDOS 2.0 + and IBM PC, or compatible, TI Professional, 
NEC APC Il, or VICTOR 9000. C-Worthy is a registered 
trademark of Custom Design Systems, Inc. 


Tech Specs 

® Compilers: Microsoft 3.0+, Quick, Turbo, 
Lattice. All models. 

wm 350+ functions written in C, 75+ in 
Assembler. 

= Menus: Fully support pop-up, Lotus style, 
MS Windows style (pull-down), pull-up. 

® Errors: DOS, program, and user. 

zw DOS Interface: 62 functions. File handling, 
dir. and drive management, date & time 
conversion, wildcards, more. 

= Help: System and context sensitive. 

mw Screens: Screen display, color palettes, save, 
restore, scroll, more. 

= Windows: Exploding, tiled, pop-up, 
overlapping. Direct video access and virtual. 
Up to 50 active at any time. 

m Keyboard Handling: Regular, function, 
interrupt, background procedures. 

w= Editing: String and word wrap text. 


=> Form Interface Library: 118 functions. 
Over 15 field types, and user definable field 
types. 3 levels of data validation: type, 
multiple field ranges, optional validation 
procedures. Hide, lock, or secure a field. 
Optimal field movement. 


> Foreign Languages: All text messages in 
separate files for easy translation. 


2% Compatible with MS Windows. 
@ OS/2 special overlay when released. 


w Machines: Autodetect for MDA, CGA, 
EGA, VGA, TI, AT&T, Victor. 


z No royalties. 


“I heartily recommend this package. ‘ 
— David A. Schmitt, president, Lattice, Inc. 


Over 400 developers in 16 countries already use it. 


Thorough Documentation 


Indexed alphabetically and by category, 
the 700+ page Reference Guide includes 
for each function: an example, description, 
calling conventions, return values, and 


related functions. The 250 page User’s 
Guide gets you going with its tutorial 
and “Getting Started” sections. 
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“C- Worthy is a comprehensive C library whose 
time has come. I heartily recommend it as your 
next purchase.” —Computer Language, 8/87 





C-Worthy Interface Library: 


Object Only 3 GW $ 195 
Form Interface Library add-on..... $ 100 
Object with Forms ............... $ 295 


Object with Forms & Library Source. . .$ 495 


Please specify compiler and version when ordering. 


To Order Call 


(800) 821- 2492 
in MA (617) 337-6963 





541-D Main Street, Suite 410 
South Weymouth, MA 02190 


ISN'T IT A PITY... 





Everything Isn‘t As 
Accommodating As 


™ | 
c-tree owe 
FILE HANDLER O= 


Multi-Key ISAM functions @ fixed and variable length data records 
@ record locking @ variable length keys and key compression 

B overcomes OS file limits & state-of-the-art B+ Trees @ simplified 
installation 


New version includes c-tree server ® much faster access to shared 
files @ the industry's first portable server runs with Net Bios, UNIX 
systems, PC-NET compatibles, XENIX systems, Novell (including 2.1 
VAP), VAX/VMS @ server design supports LANS and multi-tasking 
systems 


™ 
r-tree 
REPORT GENERATOR 


Saves days of coding @ no printer spacing charts # change reports 
without recoding ® unlimited control breaks, accumulators and 
virtual field calculations ® powerful search, select and sort 
operations over multiple files # automatic file traversal & easy report 
layout 





Unparalleled portability @ our code is running in over 60 system 
environments @ DOS, UNIX, OS/2, XENIX, Macintosh, Tower, VAX, 
CRAY... @ all popular C compilers on DOS and other OS's 


More for your money & for one low price, you get complete source 
code for single and multi-user applications ™ no royalties 

® unlimited tech support @ free upgrade listings ™ freedom to port 
our code to all your machines 


How to order: Put FairCom’s leadership in programmer utilities to 
work for you. Order c-tree today for $395 or r-tree for $295. When 


purchased together, r-tree is only $255. For VISA, MasterCard and 
COD orders, call 314/445-6833. FAX 314/445-9698, 


gPO. 
ey 


FairCom 


4006 West Broadway 
Columbia, MO 65203 





Complete C Source Code and No Royalties! 


The following are trademarks as noted: UNIX/AT&T, XENIX/Microsoft. Inc. NOVELL/ Novell, Inc., VAX/DEC, TOWER/NCR Corp., MACINTOSH/Appie Computer, Inc 
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STRUCTURED PROGRAMMING 


(continued from page 108) 





For a large array occupying a heap 
node, figure the overhead at 16 
bytes, which leaves 65,521 for data. 
Divide that by the size of the array’s 
data type to find out how many 
elements will fit, truncating any frac- 
tional result. Table 1, page 111, lists 
the sizes of some common data 
types. 

Taking Turbo Pascal reals as an 
example, 65,521/6= 10,920 array ele- 
ments. That’s an approximately 
square matrix of 104 X 105, or one of 
26 X 420, or any other combination 
of multiples and  submultiples 
whose product is 10,920 or less. Simi- 
larly, a 64K array of IEEE doubles 
can have 8,190 elements, or 90 X 91, 
182 X 45, 30 X 273, and so on. 

Assuming that’s enough for your 
matrix, it’s easy to make the neces- 
sary declarations and allocate the 
space. You might define the array in 
Pascal as: 





TYPE arrayPtr = “bigArray; 
bigArray = ARRAY ([1..90, 1. .91) 
OF DOUBLE; 


and declare a pointer variable as: 
VAR arr : arrayPtr; 


Allocation is then accomplished 
with the standard procedure NEW 
(arr1);, after which you can refer to 
elements with the notation arr1” 
[row, col]. 

Pascal/Modula-2 pointer types 
such as arrayPtr are automatically 
32-bit segment:offset objects. You 
can therefore allocate several 64K 
arrays on the heap and, using sub- 
scripted pointer notation as above, 
compare and combine them. 

Listing One, page 86, illustrates 
this with a program named mad- 
dints.pas. It adds two integer matri- 
ces, each 180X180, and stores the 
results in a third heap node. An 
array of 180X180 encompasses 
32,400 elements, or 64,800 bytes. 
There are three such arrays, occupy- 
_ ing a total of 194,400 bytes of heap 
space. 

Maddints is somewhat artificial in 
that it sets both addend arrays to the 
Same values, where each element 
contains a quantity computed as: 
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D -lrew,*.col) .:=-.. (row * 40) -+ 


column; 


Thus the elements of the first row 
of bath A and.B are 11, 12, 13,.. =; of 
the second 21, 22, 23, ..., and so on, 
and the elements of the sum array C 
are double those of the sources (22, 
24, 26, ...). To make this into a 
real-world program, revise the Ac- 
guire procedure to read the data 
from an external source such as a 
disk file and add a procedure to 
output the results to a suitable 
medium. 


Matrices Bigger Than 64K? 
Truly huge matrices require a bit 
more ingenuity to live within the 
means of 64K segments. In this case, 
each row of the matrix is a separate 
array of up to 64K in size, with the 
subscripted elements representing 
columns. A matrix of n rows con- 
sists of n such horizontal lists. The 
glue that holds it together is another 
array—a vertical list containing n 
pointers to the rows in sequence. 
Figure 1, this page, illustrates this 
structure, where D points to an array 
of pointers, each of which points to 
an individual row. 

Conceptually, the matrix elements 
can be regarded as D [1..n, 1..Z], 
where n is the number of rows and 
z the number of columns. Because 
of pointer following, however, the 
actual Pascal/Modula-2 notation is 
more complex. The next couple of 
paragraphs develop the notation 
based on a model. 

You can define the types for this 
matrix structure as: 


TYPE dataObj = WORD; {or what- 
ever type is appropriate} 

colPtr = “colArray; { pointer to a 
row } 

colArray = ARRAY [1..maxCols] 
OF dataObj; { row } 

colNode = RECORD 

col : colPtr; { row pointer 
node } 
END; 

rowPtr = “rowArray; 

rowArray = ARRAY [1. .maxRows] 
OF colNode; { list } 


The sanity of defining the 
colNode record with only one field 
will become apparent when you see 
the actual notation. Also, it seems 
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contradictory to use the names 
colPtr, colArray, and so on in refer- 
ring to a row, until you realize that 
you use these objects to identify a 
specific column within a given row 
using subscripts. 

The variables declared from these 
type definitions are very simple: 


VAR A, B, C : rowPtr; 


That is, the only variables deriving 
from the types are pointers to the 
controlling lists for the three matri- 
ces A, B, and C. After creating the 
matrices, you can refer to individual 
elements by following the pointer 
structure. For example: 





Figure 1: Structure of a huge array 











A’ [25].col* [287] 


refers to the element in row 25, 


Type 
Char, byte 
Integer, word 
Long integer 
Pointer 
Turbo Pascal real 
IEEE single 
IEEE double 
IEEE extended 
IEEE comp 


Table 1: Some common data types 
and their storage sizes 


The C Programmer's Assistant 


C TOOLSET © 





Unix-like Utilities for 
Managing C Source Code 


No C programmer should be with- 
out an assistant. C ToolSet provides 
you with the support you need to 
make C programming easier. 

All of the utilities are tailored to 
the C language but you can modify 
them to work with other languages 
as well. 

Source code in standard K&R C 
is included. You are welcome to use 
it with any compiler (UNIX com- 
patible) and operating system you 
choose. 

The documentation contains de- 
scriptions of each program, a listing 
of program options, and a sample 
run. On-line help responds to -? on 
the command line with a list of 
options 


The 
Coder’s 
Source ” 


Ow 


@® 


12 Time Savers 


DIFF - Compare files line by line; 
use CMP to compare byte by byte. 
GREP - Regular expression search. 
FCHART - Trace the flow of control 
between large program modules. 
PP - Format C program files so they 
are easier to read. 

CUTIL - General purpose file filter. 
CCREF - Cross reference variables. 
CBC (curly brace checker) - Check 
for pairing of curly braces, parens, 
quotes, and comments. 

Other utilities include DOCMAKE, 
ASCII, NOCOM, AND PRINT. 
Requires MSDOS and 12K RAM 


MONEYBACK GUARANTEE 


Try C ToolSet ($95) for 30 days — 
if not satisfied get a full refund. 


Call (800) 255-4659 


In MA (617) 331-0800 


541-D Main St., Suite 412, So. Weymouth, MA 02190 
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when youdon’t | 
have to: 












Micro/Systems Journal has the answers. that M/S/ is famous for 

Whether it’s networking, systems integration, providing . . . in-depth 

programming, or scientific computing tutorials, reviews, hints, 

questions, M/SJ will lead you out of the maze latest on multitasking, languages 

of microcomputer mayhem. With each issue and operating systems. So stop your 

you'll find comprehensive coverage of all the puzzling . . . subscribe right now and the answers 
technical information that will keep you will be yours. Simply drop the attached card 
up-to-date with the ever-changing microcom- in the mail—that’s all there is to it. 
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STRUCTURED PROGRAMMING 
(continued from page 111) 


column 287. 

An ever-present danger when work- 
ing with huge arrays is that you'll 
run out of heap space. Most lan- 
guages furnish an intrinsic function 
to inquire about space availability. 
Logitech Modula-2, for example, has 
an AVAILABLE function that returns 
a Boolean indicating if the requested 
number of bytes can be allocated; 
Turbo Pascal 4.0 has maxAvail, 
which returns the size of the largest 
contiguous block. Before attempting 
to allocate space for a huge array, 
inquire whether your request will 
be honored. If it won't be, terminate 
gracefully. This is preferable to 
simply letting the program crash 


| with some arcane run-time error mes- 


sage. 

Listing Two, page 86, is a program 
hugemats.pas, written in Turbo 
Pascal 4.0, that implements this dis- 
cussion. It’s similar to Listing One, 
except that the matrices are 250 
rows by 300 columns, or 75,000 ele- 
ments apiece. Because the data 
object is of type WORD (an unsigned 
integer), this comes to 150,000 byte 
per matrix for data, plus 1,000 byte 
for the 250 row pointers, for a total 
of 151,000 byte. There are three such 
matrices, claiming 453,000 byte of 
heap space. 

That's too much data for the pro- 
gram to run in the Turbo Pascal 
interactive environment, which pro- 
vides less than 300K of heap space 
on a 640K machine. Because of the 
space checking in the create proce- 
dure, the program will always termi- 
nate with an out-of-memory mes- 
sage if the Turbo Pascal environ- 
ment is resident. On my machine, 
the compiled .EXE program running 
alone has only about 20K of heap 
space left after the three matrices 
are created, but that’s enough for it 
to run. 


Freeing Up More Space 

Huge number crunchers such as 
those in Listings One and Two are 
typically bare-bones programs, avoid- 
ing slick user interfaces and other 
memory-gobblers. Remember, every 
little nicety in a program consumes 
precious memory and eats into the 
heap. If you're tight on space, cut 
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“During the next 10 years, millions of programmers 
and users will utilize OS/2 ...The best way for them to 
understand the overall philosophy of the system will be 
to read this book.’’ Bill Gates 


INSIDE OS/2. Here—from Microsoft’s Chief 
Architect of Systems Software — is a candid and ex- 
citing technical examination of OS/2. In unprece- 
dented detail, Gordon Letwin explores the 
philosophy, key development issues, programming 
implications, and future of OS/2. And he provides 
the first in-depth look at each of OS/2’s design ele- 
ments — how they work alone and their roles in the 
system. INSIDE OS/2 is a valuable programmer-to- 
programmer discussion of the graphical user inter- 
face, multitasking, protection, encapsulation, inter- 
process communication, and more. You can’t get a 


more inside view. $19.95. 


Microsoft’ Press 


Quality Computer Books 


Available wherever books and software are sold. 
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STRUCTURED PROGRAMMING 
(continued from page 113) 


out the gimmicks. 

The stack is another place you 
can mine for memory. In Turbo 
Pascal 4.0, the default stack size is 
8,192 byte; it’s 8,000 byte in Logitech 
Modula-2. That’s a waste of memory 
for programs such as those given 
here, which never have more than 
about 20 byte on the stack at once. 
Trim the stack down to a minimal 
size. The savings go into the heap, 
where you can use them produc- 
tively. 

Don't forget to free up dynamic 
space that’s no longer needed. For 
structures such as those given in 
Listing One, you can loop through 
rowArray, calling freeMem in Turbo 
Pascal (or its equivalent in other dia- 
lects) to dispose of allocated nodes, 
and then free rowArray itself. 

If your data requirements are still 
too huge to fit, you'll either have to 
give up on the PC or else resort to 
memory-stretching — technologies 
such as EMS (which I'll discuss in a 
future column). The techniques 
shown here, however, should satisfy 
most requirements for working with 
huge arrays on the PC. 

The suggestion for this month’s 
column came from Dr. Don Walters, 
Professor of Physics at the U.S. Naval 
Postgraduate School in Monterey, 
Calif. If you have a programming 
issue youd like to see addressed 
here, drop me a line (no calls, 
please) in care of DDJ. Or send an 
MCI message to KPORTER, Moun- 
tain View, Calif. No promises, but I’ll 
tackle as many as I can. 


Availability 

All the source code for articles in 
this issue is available on a single 
disk. To order, send $14.95 to Dr. 
Dobb's Journal, 501 Galveston Dr., 
Redwood City, CA 94063, or call (415) 
366-3600, ext. 216. Please specify the 
issue number and format (MS-DOS, 
Macintosh, Kaypro). 


DDS 
(Listings begin on page 86.) 


Vote for your favorite feature/article. 
Circle Reader Service No. 5. 
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DOS ENCYCLOPEDIA —the starting place for 
data, advice, and insight that will make your MS- 
DOS programs reliable, robust, and efficient. THE 
MS-DOS ENCYCLOPEDIA is a programmer’s 
dream. 1600 pages packed with version-specific 
data. Annotations of more than 100 system function 
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3.2, with a special section on version 3.3. $134.95, 
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Available wherever books and software are sold. 
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REVIEW 


EXAMINING ROOM 


Turbo Pascal, 


Version 4.0 





Target: 


IBM PS/2, PC AT, and true compatibles 


Requires: 


DOS 2.0 or later; 384K for the integrated environment or 256K for the 


command-line environment 
Price: 

$99.95 

Vendor: 


Borland International, 4585 Scotts Valley Dr., Scotts Valley, CA 95066; 


(408) 438-8400 










ith Version 4.0, Borland has 
turned its highly successful 
Turbo Pascal into a language pack- 
age well suited to serious software 
development. Until now, Turbo 
Pascal has been a structured lan- 
guage suited for small, individually 
written projects. Previous versions 
have had certain limitations that 
barred them from consideration for 
major software projects. With Ver- 
sion 4.0, Borland has given us a 
Pascal that is still every bit as useful 
to its original market and that is also 
a worthy compiler for commercial 
and academic programmers. 

Turbo Pascal 4.0 offers several new 
| enhancements both to the Pascal 
language and to its programming 
environment. One example, the 
graphics unit, furnishes the most 
comprehensive set of screen-han- 
dling routines that I’ve seen with 
any general-purpose programming 
language. I'll discuss it presently, 
but first I'll look at some of the 
particulars. 

Turbo Pascal 4.0 corrects the fol- 
lowing oft-heard complaints regard- 
ing earlier versions: 


@ Each code and data segment lim- 
ited to 64K: Version 4.0 code can be 
of any size up to the total of avail- 


Ron Copeland, associate editor, is 
the coordinator for this review sec- 
tion. He welcomes your feedback on 
products worth reviewing. 
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able memory. The data segment is 
still limited to 64K of globals, as it is 
with most other compilers for the 
PC, but as with earlier releases, you 
can overcome the 64K data limit by 
using dynamic allocation. 


@®No modular compilation: Version 
4.0 encourages programmers to use 
separately compiled units. Programs 
thus become collections of precom- 
piled modules (.TPU files) glued to- 
gether by a main program. 


® No object libraries: Version 4.0 fur- 
nishes utilities for managing com- 
piled object libraries. 


® Produces only .COM files: Version 
4.0 produces .EXE files, and no sepa- 
rate link step is required. For equiva- 
lent programs compiled with other 
releases, the .EXE file is considerably 
smaller. 


@iInserts unnecessary code into 
executable files: Version 4.0 opti- 
mizes the code, removing unneces- 
sary instructions and unused rou- 
tines. 


@®Not compatible with standard 
Pascal: Version 4.0 is almost compat- 
ible with the ANSI/IEEE770X3.97-1983 
standard. The well-documented list 
of exceptions runs at less than two 
pages, many of them overriding coun- 
terproductive requirements of the 
standard. For example, the standard 


forces a program to abnormally end 
(abend) if there is no clause for the 
selectors current value in a CASE 
statement; Turbo Pascal 4.0 just falls 
through the CASE unless there's an 
ELSE clause. 


Three levels of compilation are 
available. At the lowest level is a 
simple compile of the current unit. 
Next higher is Make, which recom- 
piles the current program and any 
units that have been changed since 
the last compile. At the highest level 
is Build, which unconditionally com- 
piles all the parts of an application. 

The complete user interface is 
awakened by the TURBO command, 
which starts TURBO.EXE running. 
For hairy-chested traditionalists, a 
command-line compiler (TPC.EXE) is 
also available, replete with Unix-like 
switches. I can’t imagine why 
anyone would prefer TPC; it doesn't 
furnish nearly as much functionality 
(although the language is exactly 
equivalent), and command-line com- 
pilers aren’t much fun. 

Whichever, compile speed is blaz- 
ingly fast. Borland claims 27,000 
lines per minute on an 8-MHz AT, 
which is the machine I have. Al- 
though I’m unwilling to write 27,000 
lines of code simply to prove the 
company right or wrong, I'll say this: 
a 600-line program compiles fully 
before my finger leaves the com- 
mand key. Even on an old 4.77-MHz 
XT, Turbo Pascal 4.0 compiles equiva- 
lent code as or more rapidly than 
Turbo C on the AT. And Turbo C is 
no slouch. 


Linking 

Both the integrated and command- 
line compilers take the somewhat 
unusual approach of incorporating 
the linker. This substantially de- 
creases the overall cycle time from 
PAS to resulting EXE. The built-in 
linker brings in .OBJ files in stan- 
dard Intel relocatable format; it iden- 
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If you ever, 
wanted to 
take acrack % 
at assembly 


‘You probably already 
know that assembly 
language subroutines 
are the smartest way to 
get the fastest programs. 

But if the complexities 
of working in assembler 
made you think twice, 
here’s some good news. 
We've made Microsoft® 
Macro Assembler Version 
0.0 a lot easier to use. 

We eased the learning 
process by giving you the best 
support around. We com- 
pletely revised our docu- 
mentation. The new Mixed 
Language Programming 
Guide gives you step by step 
instructions for linking your 
assembly code with Microsoft 
QuickBASIC, C, FORTRAN, 
Pascal and other languages. And 
you get a comprehensive refer- 
ence manual with listings of the 
instruction set and examples of each instruc- 
tion. We didn’t stop there, though. You also 
get an on-disk collection of templates 
and examples. 

We've also dramatically simplified the 
high-level language interface. In just a few 


nows 
the time. 


simple steps, you can be 
calling Macro Assembler 
subroutines from pro- 
grams written in your 
favorite language. 
Now that you're writ- 
ing the fastest programs, 
Microsoft is giving you 
the fastest way to de- 
bug them. For the first 
time, we ve added our 
CodeView® debugger 
to Macro Assembler. 
With source code 
and comments on your 
screen, Microsoft Code- 
View makes debugging pro- 
srams containing assembly 
language subroutines a snap. 
And you'll be glad to know that you 
don’t sacrifice any speed for all the ease of use. 
We took the fastest Macro Assembler on 
the market and made it even faster. 
So what are you waiting for? Get your 
hands on Microsoft Macro Assembler and 
see what it’s like to break your personal 


speed limit. 
Microsoft: 


For more information or for the name of your nearest 
Microsoft dealer, call (800) 426-9400. In Washington State and 


Alaska, (206) 882-8088. In Canada, call (416) 673-7638. 


Microsoft, the Microsoft logo and CodeView are registered trademarks of Microsoft Corporation. 
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BRIEF 2.0 


Users and industry press alike have 


unanimously proclaimed BRIEF as 
the best program editor available 
today. Now, the best gets better, 
with the release of BRIEF 2.0. 
Straight from the box, BRIEF offers 
an exceptional range of features. © 
Many users find that BRIEF is the 


only editor they'll ever need, with — 


features like real, multi-level Undo, 
flexible windowing and unlimited 

file size. But BRIEF has tremendous 
hidden power in its exclusive macro 
language. With it, you can turn BRIEF 


Signe. 


541 Main Street 
Suite 410D 


into your own custom editor con- 
taining the commands and features 
you desire. It's fast and easy. 

Jerry Pournelle, columnist for BYTE 
magazine summed it all up by saying 
BRIEF is, ‘‘Recommended. If you 
need a general purpose PC program- 
ming editor, look no further’ His 
point of view has been affirmed by 
rave reviews in C JOURNAL, 
COMPUTER LANGUAGE, DR. 
DOBB'S JOURNAL, DATA BASED 
ADVISOR, INFOWORLD AND 
PC MAGAZINE. _ 


pok at the 


se BRIEF 2.0 en 


One user stated ‘BRIEF is one of 
the few pieces of software that I 
would dare call a masterpiece.’ 
Order BRIEF now and find out why. 
BRIEF 2.0 is just $195. If you already 
own BRIEE call for upgrade 
information. 

TO ORDER CALL: 1-800-821-2492 
(in MA call 617-337-6963) 
As always, BRIEF comes with a 


30 day money-back satisfaction 
guarantee. 
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Requires an IBM PC or compatible with 
at least 192K RAM. 


BRIEF is a trademark of UnderWare, Inc. 
Solution Systems is a trademark of Solution Systems. 
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EXAMINING ROOM 
(continued from page 116) 


tifies them via the $L switch, which 
names the .OBJ file. This allows you 
to link with modules written in as- 
sembly language or in C using the 
Pascal calling conventions. 

Oddly, the compiler doesn’t con- 
vert Pascal source files into .OBJ 
format. Source files beginning with 
the UNIT keyword become .TPU- 
compiled files, and those starting 
with the PROGRAM _ keyword 
become .EXEs. The linker automati- 
cally merges any .TPU units into the 
final product, identifying them from 


For backward 
compatibility, 
Version 4.0 offers 
two units called 
Turbo3 and Graph3 


the USES statement. 

Although this unconventional ap- 
proach is valid most of the time, it 
makes an assumption that might 
not be universally true: that you 
want only to link foreign-language 
modules into Pascal programs and 
not the other way around. The ab- 
sence of .OBJ output files and of any 
option to create them makes it im- 
possible to export compiled Turbo 
Pascal modules to other languages. 
In effect, the built-in linker creates a 
one-way street leading from other 
languages to Turbo Pascal. You 
could wish it were a two-way street. 


Compatibility with 
Version 3.0 
Speaking of two-way streets, Version 
4.0 does better with regard to Turbo 
Pascal 3.0 compatibility. Both 
upward and downward options are 
available. 

A utility program called UPGRADE, 
distributed with Version 4.0, proc- 
esses Version 3.0 source files in sev- 
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eral different ways. One way marks 
up the original source file, pointing 
out obsolete Version 3.0 conventions 
and explaining what needs to be 
done. For experienced 3.0 program- 
mers, this is a good way to find out 
where the mosquitoes are hiding, 
waiting to bite. Another method 
merges and unifies the source files 
for overlays and their parent in 
order to create a monolithic (multi- 
ple code segment) application. 
There are other options as well. UP- 
GRADE is a forward-compatibility 


tool. 

For backward compatibility, Ver- 
sion 4.0 offers two units called 
Turbo3 and Graph3. These allow a 
Version 4.0 program to employ 3.0 
features such as turtle graphics, 
which Version 4.0 doesn’t support. 

The manual has a 20-page chap- 
ter devoted to converting from Ver- 
sion 3.0 to 4.0 in addition to a 12- 
page appendix detailing the differ- 
ences between the two. That ought 
to give you some idea of the extent 
to which Turbo Pascal has been ex- 
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Simply the BEST C and 
Pascal on AT, 386, Sun, 
Apollo, RT, VAX, 370 


“The most rock-solid C compiler in the industry. Superb technical 
support and portability. Superior code generated.” 

Gordon Eubanks, Symantec — Q&A (386). 

“Tt simply works, with no trouble, no chasing strange bugs, and ex- 
cellent warning and error messages ... a professional product.” 

Robert Lerche, Bay Partners. 

“For large-scale software development, the highest quality C compiler 

available on the market today. Pragmas are great. Quality of 

support is exceptional.” Randy Neilsen, Ansa—Paradox (DOs,0s/2). 


“15% smaller and 15% faster than Lattice C.” 
Robert Wenig, Autodesk. 


“Our software is running anywhere from 30 to 50% faster than when 
compiled under Lattice.” David Marcus, Micronetics. 


“We switched from Lattice due to a 10% reduction in code size. The 
compiler is very stable.” Lee Lorenzen, Ventura Software 

— Ventura Publisher, marketted by Xerox Corp. 

“Best quality emitted code by any compiler I've encountered. Often a- 
mazing.” Bill Ferguson, Fox Software — FoxBase (386). 


“Messages sometimes pointed out type mismatches, incorrect-length 
argument lists, and uninitialized variables that had been undetected 
for years [in 4.x bsd].”” Larry Breed, IBM ACIS [RT PC]. 


“Diagnostics turned up bugs missed by other compilers. Rapid bug 
fixes by technical support, someone who knew what he was 
talking about. 80386 code is well optimized.” 

Tim Addison, Logistics Data Systems. 

“386 protected mode support is fantastic, especially the access to 
large amounts of memory. It's mainframe compute power on a 
PC” Dan Eggleston, Viewlogic. 

“The preprocessor supplied with Professional Pascal is quite useful. 
The code quality and control over segmentation and memory mod- 
els are superior to MS Pascal.” Bob Wallace, QuickSoft. 


Check Out These Reviews 
¢ High C ™; 


Computer Language February 1986, '87 

Dr. Dobb's Journal August 1986 

PC Magazine Jan. 27, 1987 (80386 version) 

Dr. Dobb's Journal July 1987 (80386 version) 

BYTE Magazine November 1987 (80386 version) 
¢ Professional Pascal ™: 

PC Magazine Dec. 29, 1985 

Computer Language May 1986 

PC Tech Journal July 1986 


Journal of Pascal, Ada, & Modula-2. Nov.-Dec. 1986 
BYTE Magazine Dec. '86, June '87 (80386 version) 


Why MetaWare compilers 


e They are specifically designed for serious software developers. 

e They are reliable and robust: they don't break at every turn. 

¢ Their generated code is the best, or near best, on each architecture. 

¢ Their superior diagnostic messages help you produce better prod- 
ucts more quickly. 

¢ Your source can be ported with ease to the most popular systems. 

¢ You can link mixed-language modules from our compilers, others 

¢ You can benefit from high-level, personal technical support. 

¢ You can take advantage of the latest ANSI C extensions, and/or 
extensive Pascal extensions. High C has been tracking the ANSI 
Standard for two years; Professional Pascal will soon have a 
VS Pascal compatibility switch and several Apollo Pascal ext'ns. 

¢ You can take advantage of the latest 387 and Weitek 1167 support 
— we have the only compilers with Weitek real mode support. 


Power Tools for Power Users 





Ashton-Tate: dBase III Plus, MultiMate; Autodesk: AUTOCAD, AU- 
TOSKETCH (8087, '387, Weitek); Boeing Computer Services (Sun); 
CASE Technology (Sun); CAD/CAM giant Daisy ('86, '386, VAX); 
Deloitte Haskins & Sells; Digital Research: FlexOS; GE; IBM: 
4.3/RT, 4680 OS; Lifetree Software (Pascal): Volkswriter Deluxe, 
GEM-Write; Lugaru: Epsilon; NYU: Ada-Ed cmplr; Semantec: Q&A; 
Sky Computers; ... (Product names are trademarks of the companies indicated.) 


Industrial-Strength 


MetaWare C and Pascal compilers are designed for professional soft- 
ware developers. These tools are loaded with options to control 
them for special purposes. You can adjust the space-time trade-off 
in code quality. You can adjust external naming conventions to 
agree with linkers and operating systems. You can specify segment 
names for segmented architectures, and to help place code or data in 
particular places for embedded applications. You can select from 
five memory models for the 8086 family. And on and on. 


A Partial List of Optimizations 


Common subexpression and dead-code elimination, retention and re- 
use of register contents, jump-instruction size minimization, tail 
merging (cross jumping), constant folding, short-circuit evaluation 
of Boolean expressions, strength reductions, fast procedure calls, au- 
tomatic mapping of variables to registers (where advantageous), ... 


“Platform” — Code Quality 


Sun,Apollo,SGI— 18%, 3%, 26% > resident compiler (Dhrystone). 
PC: DOS, OS/2 — 3-10% > Microsoft C; 30% > MS Pascal, LatticeC. 
386 32-bit DOS— no competitors, since November, 1986. 

286, 386 UNIX — 66% better than pcc (Dhrystone, 386). 

VAX VMS — = DEC's excellent C and Pascal; better features. 
VAX Ultrix — 19% > pec (Dhrystone); much > Berkeley Pascal. 
RT PC/4.3bsd — 89% > the original port of pec (Dhrystone). 

370 CMS,UNIX— much better than any C, and VS Pascal. 

AMD 29000 — >40,000 Dhrystones! Available in Q2, cross. 


(408) 429-6382, telex 493-0879. Since 1979. 


Mets NN, Tiki 


INCORPORATED 
903 Pacific Avenue, Suite 201 ¢ Santa Cruz, CA 95060-4429 


The Clear Choice for Large 


© 


Programming Projects — 1... 


1987 MetaWare Incorporated. MetaWare, High C, Professional Pascal, and DOS Helper are 
trademarks of MetaWare Incorporated. Others and their owners are duely respected. 
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EXAMINING ROOM 
(continued from page 119) 


panded and enhanced in Version 
4.0. 


Memory Management 

While allowing executable code of 
any size, Version 4.0 is, of course, 
subject to the 64K segmentation im- 
posed by the Intel processors. It 
gets around this by limiting the code 
in any compile unit to 64K and start- 
ing a new code segment for each 
module during linkage. Thus, in- 
trasegment calls (to local subrou- 
tines) are near calls employing 16- 


An option 
lets you set 
the stack size 
to something 
besides 8K 


bit offset pointers and those to exter- 
nal routines and to subprograms 
named in the interface portion of 
units are implicitly far (32-bit seg- 
ment:offset) calls. Programmers have 
no control over these compiler-gen- 
erated calling conventions. 

You can, however, force a rou- 
tine—or an entire compile unit— 
into far mode with the $F switch, in 
which $F + turns on far calls/returns 
and $F- reverts to default (compiler- 
controlled) calling conventions ac- 
cording to the rules above. An exam- 
ple of needing a far routine is when 
furnishing a mouse event handler: 
the handler is called as a far proce- 
dure from the device driver in low 
memory and thus must return with 
RETF. If the procedure heading is 
surrounded by the $F switches, its 
entire body is forced to far. 

The DS register holds constant 
throughout the code, no matter how 
many code segments there are. Con- 
sequently, global data is limited to 
64K, and references to global vari- 
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ables are always 16-bit offsets rela- 
ative to DS. As in most high-level 
languages (and identically to Ver- 
sion 3.0), local variables for subpro- 
grams are allocated on the stack 
relative to the BP register and so do 
not count against the 64K limit for 
globals. Pointers to dynamic objects 
allocated on the heap are 32-bit seg- 
ment:offset variables, allowing them 
to be passed freely among various 
code segments. 

The default stack for a 4.0 pro- 
gram is 8K, and the heap is all of 


uncommitted memory above the 
stack. This eliminates the need to 
be concerned (as you were in Ver- 
sion 3.0) about heap/stack collisions, 
but of course it’s possible for a 
highly recursive program to drive 
the stack down into the data seg- 
ment. An option lets you set the 
stack size to something besides 8K 
and also to claim a finite area for the 
heap. The latter is important in mul- 
titasking and TSRs, neither of which 
can assume that they own all of 
memory. 


Speed. 


Fast Execution Speed. 


Microsoft® C 4.0 
5.7 


Sieve (25 iterations) 
Loop 
Float 


Dhrystone 
Pointer 


Microsoft C 5.0 
11.0 0* 
19.9 : 

ae : 


« New optimizations generate the fastest code: 
— Inline code generation. NEW! 
— Loop optimizations: NEW! 
— Loop invariant expression removal. NEW! 
— Automatic register allocation of variables. NEW! 
—Elmination of common sub expressions. 
—Improved constant folding and value propagation. 
- Fine tune your programs for even greater speed: 
— Coding techniques for writing the fastest possible 
programs are incladed in the documentation. NEW! 
—Segment Allocation Control: 
—Group functions into the same segment to get faster 


NEAR calls. NEW! 


— Specify which segments receive variables to yield 
faster NEAR references. NEW! 
— Uses register variable declarations. 
— Mix memory models using NEAR, FAR & HUGE 


pointers. 
*Time is negligible. 
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The Advanced UNIX, SCO Xenix or 
Programmer's Editor 


That Doesn't Waste Your Time 


Oh YF: 


Protected Mode 


e Fast, EMACS-style commands—completely reconfigurable 
e Run other programs without stopping Epsilon—concurrently! 


e C Language support—fix errors while your compiler runs 

e Powerful extension language =e Great on-line help system 
e Multiple windows, files e Regular Expression search 
e Unlimited file size, line length e Supports large displays 

e 30 day money-back guarantee e Not copy protected 


Only $195 


Software Ltd. 


5843 Forbes Avenue 


Pittsburgh, PA 15217 for IBM PC/XT/AT’s or compatibles 
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yw Hire a Pro for 
ew New Turbo 40 


urn on the power of Turbo PROFESSIONAL 4.0, a library of more 
than 300 state-of-the-art routines optimized for Turbo Pascal 4.0. 
You'll have professional quality programs finished faster and easier. 


Turbo PROFESSIONAL 4.0 includes complete source code, 
comprehensive documentation and demo programs that 
are powerful and useful. The routines include: 





















¢ Pop-up resident routines 

¢ BCD arithmetic 

e Virtual windows and menus 

¢ EMS and extended memory access 

¢ Long strings, large arrays, macros, 
and much more. 


Turbo PROFESSIONAL is only $99. 


Call toll free for credit card orders. 


i ame 1-800-538-8157 extension 830 
1-800-672-3470 extension 830 in CA 


Satisfaction Guaranteed or your money back within 30 days. 





Turbo Pascal 4.0 is required. Registered 
owners of Turbo Professional by Sunny 
Hill Software may upgrade for $30. 
Include your serial number. 


For other information call 408-438-8608, a 

9 AM to 5 PM PST. Shipping & taxes u Bat 

prepaid for US and Canadian customers, 

others please add $6 per item. 

TurboPower Software 3109 Scotts Valley Dr., Suite 122 Scotts Valley, CA 95066 
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An important addition to the Ver- 
sion 4.0 arsenal is a special interrupt- 
class procedure, which allows you 
to embed custom interrupt-service 
routines into your applications. 
These can be chaining routines 
(“hooks”) that intervene in standard 
system interrupts, replacements for 
such things as the critical error han- 
dler, or new software- and hardware- 
driven routines activated via uncom- 
mitted vectors. An interrupt proce- 
dure looks much like a normal 
Pascal procedure, except that the 
INTERRUPT keyword follows the 
heading. Also, the heading can name 
the CPU registers you want pre- 
served on the stack (subject to se- 
quencing rules), and you can then 
read and write them as local vari- 
ables. 

A particularly nice feature is that 
the entry processing points the DS 
register to your program's data seg- 
ment, furnishing direct access to all 
the program's globals. Because an 
interrupt procedure returns via an 
IRET after reloading the parametric 
registers from the stack, you cannot 
call it like a normal subroutine from 
within your program. That's as it 
should be. This feature alone makes 
Turbo Pascal, Version 4.0, a worth- 
while compiler for serious develop- 
ers. 


Graphics 

Another enhancement that scores 
high on the programmer's Richter 
scale is a new graphics unit. Encom- 
passing some 60 functions and pro- 
cedures, it provides a comprehen- 
sive set of primitives for controlling 
the display. These include optional 
automatic detection of the system's 
video capabilities and selection of 
the “best possible’ mode among 
CGA, EGA in its many incarnations, 
VGA, Hercules, AT&T, and PC3270. 
You can also inquire about the dis- 
play options available and force a 
particular mode selection. 

Once in a graphics mode, the 
graph unit provides various line 
styles and widths as well as drawing 
and filling routines for common 
visual objects (bars, circles, polygons, 
rectangles, and so on). You can par- 


tition off viewports, set clipping 
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boundaries, inquire about the 
screen’s aspect ratio, monitor error 
status, and perform a host of other 
useful graphics operations. The 
graph unit supports bitbit opera- 
tions for high-speed image transfers, 
including XOR, OR, NOT, and AND. 
This is a substantial improvement 
over Version 3.0’s PutPic/GetPic op- 
erations, providing for much more 
sophisticated animation effects. 

Also furnished with the graph 
unit are four stroked fonts: triplex, 
small, sans serif, and gothic. Unlike 
conventional bit-mapped character 
fonts, stroked fonts allow for justi- 
fied and variable text sizes up to 
10 x that can originate at any pixel 
(rather than character cell) position 
and can be oriented either horizon- 
tally or vertically. 

By default—in both text and graph- 
ics modes—Version 4.0 writes di- 
rectly to screen memory rather than 
going through conventional DOS/ 
ROM BIOS calls. This makes for ex- 
tremely fast output. You can over- 
ride the default, and a CheckSnow 
procedure is thoughtfully provided 
to prevent the unsightly “snow” oc- 
curring on older CGAs during direct 
screen writes. Nevertheless, the line- 
drawing routine is not particularly 
fast. 

The 4.0 graph unit is impressive, 
providing the kind of display control 
and intrinsic graphics calls that 
make visual programming fun and 
easy. Unfortunately, it doesn’t con- 
form to any graphics interface stan- 
dard (GKS, PHIGS, or whatever) and 
thus lacks high-level routines for 
axis rotation, scaling, and other co- 
ordinate transformations. Still, just 
about everything you need for graph- 
ics power is there. 


Data Types 

Version 4.0 offers several new data 
types. There are still six basic types- 
string, char, Boolean, pointer, inte- 
ger, and real—but the latter two 
have more choices. 

The integer types and their char- 
acteristics are shown in Table 1, this 
page. The fundamental floating- 
point type in Version 4.0 is the same 
6 found in earlier versions. The old 
Turbo-87 became a has-been with 
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Type 


byte 


Range 


0. 295 


shortint —128. .127 
integer —32768. .32767 


word 


0. .65535 


longint —2147483648. 2147493647 








Table 1: Integer types and their characteristics 


Speed. 


Fast Compilation. 
Fast Prototyping. 


Microsoft C Version 5.0 includes QuickC™ which 

lets you edit, compile, debug, and execute in an 

integrated environment. It’s ideal for prototyping. 

¢In-memory compilation at 10,000 lines/ 
minute. NEW! 

¢ Built-in editor with parentheses, bracket and 
brace matching. 

- Use the integrated debugger to animate through 
your program, add watch variables and set 
dynamic breakpoints. NEW! 

- MAKE file is automatically generated for you. 
Simply indicate the modules you want to use, 
then MAKE recompiles and links only those 
modules that have changed. NEW! 

¢Full C 5.0 compatibility: 

— Completely source and object code compatible. 
— Emits CodeView®-supported executables. 
— Identical compile/ink command line switches. 
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‘ Professional C function library 
‘ 30 day money back guarantee 
Y Multiple bullet proof windows 





4 Easy full screen data entry 

¥ Unlimited data validation 

‘¥ Context sensitive help manager 
‘ Menus like Lotus and Mac 

4 Programmable keyboard handler 
4 Text editor routines 

¥ No royalties or runtime fees 
Library source included FREE 
Free technical support 

M Free BBS at (214)418-0059 

¥ Supports all major compilers 





including Microsoft 5.0 
‘ VCScreen code generator too! 
‘ UNIX version avaialable, 

call for details 
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Version 4.0, which offers four addi- 
tional real types compatible with 
IEEE Standard 754 and usable only 
on an 80x87 math coprocessor; no 
IEEE emulation package is available. 
What's more, the compiler won't let 
you declare variables of these new 
types unless you specify the $N 
switch, explicitly stating that your 
target system has a coprocessor. 
Table 2, this page, gives the available 
real types. 

Pointers are ordinarily bound to a 
type, but they can be passed as 
untyped parameters to a function 
or procedure. One unfortunate ex- 
ception to the ANSI standard is that 
Version 4.0 doesn't support the pass- 
ing of procedural and functional pa- 
rameters; that is, procedure B can't 
accept a pointer to function A, then 
pass control to function A using the 
pointer. You couldn't do this in ear- 
lier Turbo Pascal versions either, so 
nothing’s changed in that regard, 
but because the standard mandates 
it and because it’s one of those 
things that makes C such a powerful 
systems programming language, Ver- 
sion 4.0 should have supported it. 


Here’s the Wrap 

From the beginning, Turbo Pascal 
has been controversial on two 
grounds: its limitations and its disre- 
gard of formal standards. With Ver- 
sion 4.0, Borland has removed the 
limitations. As for standards, you 
could take the position that with 
more than 600,000 legal copies avail- 
able—probably more than all other 
Pascal compilers combined—Turbo 
Pascal is the standard by sheer 
weight of numbers. Frankly, that’s 
what I expected Borland to do inas- 
much as success breeds arrogance, 
of which Philippe Kahn has never 
been found wanting. Instead, 
though, Version 4.0 has moved 
much closer to the formal standard, 
deviating—though differently in par- 
ticulars—to approximately the same 
extent as Microsoft, VAX, and other 
“purer” Pascal dialects. And that’s 
good for everybody. 

I wish Turbo Pascal 4.0 had a 
debugger and that it exported com- 
piled modules for linking with other 
languages. But what the heck, it’s 
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Type Range Digits Size 
real 10**-38. .10**38 11 6 
single 10°"—38. .10**38 7 4 
double 10**—38. .10**38 15 8 
extended 10**—4391. .10**4391 19 10 
comp 2°*63. .2**63—-1 8 2? 


18.9 digits of precision 


Table 2: Real types and their characteristics 


And speed. 


Fast Debugging. 


Microsoft C Version 5.0 includes Microsoft CodeView, 
our source-level windowing debugger that lets you debug 
more quickly and thoroughly than ever before. 

¢ Debug larger programs: 

— Debug through overlays created by the 
Microsoft overlay linker. NEW! 

— Expanded Memory Specification (EMS) 
support. NEW! 

Fast debugging through precise control of your 
program execution: 

— Access source level and symbolic debug information 
from your Microsoft C, FORTRAN, and Macro) 
Assembler programs. NEW! 

— View your source code and assembly simultaneously. 

— Watch the value of variables change as you execute. 

—Set conditional breakpoints. 

— Animate or single step through your program. 

CodeView brings you as close as you’ve ever been 

to your hardware: 

— Swap between your code and output screens. -.- © | 

— Watch your registers and flags change as your ~~ : 
program executes. ‘4 


All benchmarks run on an IBM® Personal System/2™ 
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For your free C 5.0 information packet, call: 


(800) 426-9400. 


In Washington State and Alaska, (206) 882-8088. In Canada (416) 673-7638, 
Microsoft, the Microsoft logo and CodeView are registered trademarks and QuickC 
is a trademark of Microsoft Corporation. IBM is a registered trademark and 


Personal System/2 is a trademark of International Business Machines Corporation. 
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EXAMINING ROOM 


(continued from page 125) 


got everything else, and for $99.95, 
it’s all the compiler that even the 
most demanding Pascal program- 
mer needs. 

by Kent Porter 


CodeView 





Product: 

Microsoft CodeView, Version 2.1 
Target: 

PC or PS/2 and compatibles 
Requires: 

DOS 2.0 or later 

Price: 

Comes with Microsoft MASM 5.0, C 
4.0 or later, and FORTRAN | 
Vendor: 

Microsoft, 16011 N.E. 36th Way, 
P.O. Box 97017, Redmond, WA 98073; 
(800) 426-9400 





can remember when the hardest 
thing about debugging code was 
trying to decide whether to print 
the whole link map or to just jot 


down an item or two. Printing the 
whole thing could take 20 minutes 
or more. The other tough decision 
was whether or not to compile the 
code with listing output so that I 
could follow my program at the 
source level. 

Thankfully, those days have gone. 
Symbolic debuggers did away with 
the need for the link map; source- 
level debuggers “knew’ which 
source lines went with which ma- 
chine instructions. But somehow, I 
still felt there was more a debugger 
could do for me—such as knowing 
the type as well as the address of 
variables, for example; or not inter- 
mirxing output from the debugger 
with output from the program 
under test; or setting it to watch 
certain variables for me. 

To address most of these issues, 
Microsoft created CodeView 1.0, 
which came bundled with Microsoft 
C, Version 4.0. Although memory 
was still a huge problem, at least the 
debugger knew as much as I did 
about the logistics of the program. 


The 
Heap Expander” 
version 2.0 


Now your programs can have virtually unlimited heap space using expanded 
memory, extended memory, disk space, or any combination of the three. And it’s all 
transparent. The Heap Expander’s initialization code checks the system's resources 


and uses whatever is available. 


@ Uses LIM-standard expanded memory 
if present. 


@ Uses AT-style extended memory if 
present. 
@ Swaps data to disk as needed. 


MC/VISA/COD call ; 
1-800-248-1045 x 100 (US) 
1-800-952-5560 x 100 (Idaho) 


*Idaho residents add 5% sales tax 
Foreign customers add $4.00 for shipping 
and handling. 





Libraries and Source Code for: 


@ Turbo C 
@ Microsoft C 4.0 and 5.0 
@ Turbo Pascal 3.0 and 4.0 


Requires an |BM PC, XT, AT, orclose 
compatible with MS-DOS or PC-DOS version 
2.0 orabove 


The Tool Makers 


P.O. Box 8976 
Moscow, Idaho 83843 
208-883-4979 
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Version 2.1 relieves the memory prob- 
lem by making use of expanded 
(EMS) memory. This is by no means 
a perfect solution, however. 

Microsoft CodeView has two main 
operating modes. One is purely 
prompt/command-oriented and is ap- 
propriate for use on MS-DOS ma- 
chines that do not support one of 
the conventional IBM display adapt- 
ers. The second is a windowing 
mode, usable only on MS-DOS ma- 
chines with compatible display adapt- 
ers. I'll discuss the windowing mode 
here, but nearly all CodeView’'s 
power is likewise available in com- 
mand mode. 

CodeView is easy to use, but not 
at the expense of power. Most if not 
all of Symdeb’s commands can be 
used in a dialog window. This scroll- 
ing window contains the customary 
prompt as well as output from 
issued commands. It even includes 
some history so you can go back 
and look at some output again. 

There are several other windows 
that are much more interesting. 
First, there’s the source window; in 
it, some portion of your source code, 
usually the portion being executed, 
is displayed. The source window 
has three modes—source only, as- 
sembly language only, and mixed 
source and assembly language. The 
currently executing line is in a color 
bar. 

The remaining two windows are 
optional. The register window dis- 
plays the current value of all the 
processor's registers (all 32 bits if 
the processor is an 80386 and you 
have set 386 mode in CodeView). 
The watch window displays the cur- 
rent value of arbitrary expressions, 
which allows you to monitor a vari- 
able or a more complicated expres- 
sion. 

You can set breakpoints to any 
given line simply by tapping F9. The 
desired line is displayed in high- 
intensity white, indicating a break- 
point. The dialog version of the break- 
point-set command has’ more 
power, allowing the setting of pass 
counts and commands to be exe- 
cuted upon breaking. F7 executes a 
given statement. 

There are the usual two forms of 
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Why We're Betting 


a Million Lines of Code on 
the SAS/C Compiler. 





At SAS Institute Inc., we’ve invested And when we combined these OS or CMS, for a free 30-day evalua- 
more than 10 years of research—and _ features with outstanding technical tion. We'll also send you a free copy 
over a million lines of code—in the Support and frequent updates —both of a leading benchmark program. Com- 
SAS® System, the world’s leading data provided free— software developers pare our compiler with any other. Odds 
analysis software. So you can bet we everywhere took notice. The SAS/C are, you'll choose the SAS/C compiler. 
left nothing to chance when we chose _— compiler is now the market leader, Just mail the coupon below. Or call 
the C language for the next generation —_ installed in hundreds of commercial your Software Sales Representative at 
of our software. firms and academic institutions. (919) 467-8000. 


we seiected C for the portabilivit: sa 
would bring to the SAS System, but Test It Compare It 


weren't about to risk our code on just 
any mainframe C compiler. So we tried 
them all. When none could meet our FREE for 30 Days. 
exacting requirements, we created our 





SAS Institute Inc. 


awn: the SASIC compiler We're betting you've set the same SAS Circle C) Box 8000 
: high standards. That's why we’d like Phone (ai8) sr oen 
to send you the SAS/C compiler, under ® Fax (919) 469-3737 
We Developed It. : : i 





Support It. Use It. 


Using a C version of the 


The SAS/C compiler set new standards Mgr Ste ae ver ade Lape Pol See 
for efficiency and technical quality, with: release produces the fastest 

m= A source-level debugger that code among the top 3 

includes structure display, ABEND mainframe compilers. It even 

recovery, and debugger |/0 exits for (ops our own previous | saszc 3.01 

debugging specialized applications release by 35%. | Waterloo c 


m= Reentrant object code 

=== Highly optimized generated code 

=== (se of standard IBM linkage Se ee ee 
conventions, with support for 31-bit 





Number of Loops 














addressing ; ———__—- 
=== A CMS Rexx/TSO CLIST interface | 
== Support for signal handling : Id like to put the SAS/C™ compiler to the test with a free 30-day trial, and 
including program checks and terminal : my free copy of the Dhrystone benchmark program. Give me the details. 
interrupts, and non-standard signals : Please complete, or attach your business card. 
such as timer interrupts and stack : 
overflow Name FF? 
=== Many built-in functions including : 
string handling ; Company 
=== in-line assembler. : Address 
- City State ZIP 

Telephone 
Cary, NC, USA. SASICs 2 trademark of SAS ictrte, : Mail to: SAS Institute Inc., Attn: CC, SAS Circle, Box 8000, 
Copyright © 1987 by SAS Institute Inc. : Cary, NC, USA, 27512-8000 


Printed in the U.S.A. DDJ 3/88 
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single-step—STEP INTO (F8) and 
STEP OVER (F10). STEP INTO steps 
into a function call being stepped, 
whereas STEP OVER executes until 
the stepped function returns. Both 
modes do exactly the same thing if 
there is no function call at the cur- 
rent location. Both are sensitive to 
the current source window mode if, 
in source-only mode, the single 
steps are source steps. In the other 
two modes, steps are single instruc- 
tions. 

One of the most useful additions 
to any debugger is the ability to use 
data breakpoints. Data breakpoints 
allow you to stop program execu- 
tion when a particular variable, ex- 
pression, or region of memory 
changes. Microsoft calls these trace- 
points. Of course, you may not be 
interested in all changes but only in 
the one change that results in an 
erroneous value. If you can write an 
expression that yields zero when all 
is OK and nonzero when the pro- 
gram should stop, you can use watch- 
points. 
























E, PROGRAMMERS! 
THE TooLs You NEED 
AT A PRICE YOU’LL LIKE 


Supports all index file operations. Very quick 
sequential or random access, duplicate keys, multiple 
indices, fixed and variable length data records are all supported. 


Works on top of BTree to provide a simple, yet 
powerful application program/file system interface. 

Complex filesystem manipulation becomes a snap. Provides the power 
of a database manager with the flexibility of a programming language. 










The main problem with data break- 
points is speed. Most processors 
don't implement any special mecha- 
nism for them, and as a result, a 
debugger must do a single step, 
check data breakpoints, single step, 


check, and so on. It’s easy to see 


why this can be slow. But Microsoft 
has started to take advantage of the 
80386. Tracepoints of limited range 
can be done while the processor is 
running at full speed on the 386 
because of the processor's debug 
registers. Note that watchpoints do 
not take advantage of this feature, 
and I have no idea why not. To use 
this feature, you must give /r on the 
CodeView command line, as docu- 
mented in the readme file. 

I like mice, so CodeView's mouse 
support is a big plus for me. Both 
F7 (go until) and F9 (set breakpoint) 
are implemented on the mouse but- 
tons, so these operations are simply 
point and click. You can scroll both 
the source and dialog windows and 
you can move the line between 
them using the mouse. 






75.00 < NOW 


MULTI 
-USER 
AVAILABLE 


60.00 










40.00 


Finally, a completely device independent printer library! 
lp drives any printer as accurately as possible and allows easy access to 


75.00 


its most sophisticated features. Multiple fonts, multi-column output, complex margin 






The ultimate ‘make’ utility. We couldn’t find a good one, so 
we wrote a great one. Has all kinds of powerful features including wild 


formatting, and much more. Pays for itself the first time it’s used. 


59.00 


card filename expansion, nested macros, and multiple dependency and rules defini- 
tions. Ready to go for MS-DOS; C source is there if you use another operating 


system. 


Combine & Save: Bree + ISAM + lp 159.00+ snake 199.00 


Each product includes a typeset manual, example programs, and complete C source 
code that runs on any operating system. Softfocus products may be incorporated into 


applications royalty-free. 
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Credit card orders accepted. Visa, M/C, Amex. Dealer inquiries invited. 
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One last feature is the ever-desir- 
able CONTINUE UNTIL RETURN. If 
you have traced into a procedure 
and then wish to execute until the 
function returns, simply pull down 
the Calls menu and point to the 
function to which you wish to 
return. The source window then dis- 
plays that function and the cursor 
is positioned such that pressing F7 
executes the desired result. Note 
that this feature is available only in 
window mode, not in dialog mode. 

A combination of excellent per- 
formance, richness of features, and 
a large installed base will probably 
guarantee that CodeView will remain 
a reference standard in debuggers 
for some time to come. And despite 
a few flaws, that’s as it should be. 

by Richard A. Relph 
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turn this 
into this! 






MASTER«KEY 
No Other Product Comes Close! 






An EXPERT may not know the solution, but always 
knows where to find it. 


MASTER+KEY HELPS ANYONE solve those 
confusing and frustrating software puzzles more 
rapidly and easily than any other software available, 
at any cost! It gives you know-how within hours that 
may otherwise take years of experience. Create a 
new program from an old one. DON’T REINVENT 
THE WHEEL! 


MASTER+KEY - Smart! 

MASTER-KEY is an intelligent self-documenting 
MS-DOS reverse assembler. Its sophisticated 
procedures swiftly race through massive and baffling 
object code files to effortlessly discover potential 
trouble spots. 


MASTER+KEY - Educational! 

YOU DON'T NEED TO KNOW ASSEMBLY 
LANGUAGE! MASTER-kKEY will take any program 
from your IBM-compatible computer and return fully- 
documented, easily-understood assembly language 
source code (Microsoft MASM 4.0 compatible). 


MASTER®*KEY - Easy To Use! 

MASTER-KEY works both automatically from the 
DOS command line or interactively from menus 
similar to Lotus Corporation’s 1-2-3 or Symphony. 
No need to remember any new commands or con- 
tinually refer to a manual. Use it immediately! 





























Minimum System Requirements: 
256K + 8088/8086/80186/80286/80386 PC 
MS-DOS or PC-DOS 2.0 + 
One 360K DSDD Floppy Drive (IBM PC Format) 


MS-DOS is a trademark of Microsoft. 
PC-DOS is a trademark of IBM. 










MASTER*KEY will guide you 
1. 


Help you learn assembly language, if you desire. 
2. Discover how any program runs or why 
it doesn’t. 
3. Alter or remove unwanted object code from 
any program. 
4. Incorporate routines from compiled programs 
into other assembly language, Basic, C, or 
Pascal programs. 


Dealer/Distributor Inquiries Welcome 


Sharpe Systems Corporation 
2320 E Street, Dept. 44, La Verne, CA 91750 714-596-0070 


C:>DEBUG PROGRAM.COM 
-D100 136 
8848:0100 
8848:0110 
8848 :0120 
O. 6848:0130 

_», -O 


CD 21 CD 20 58 EB 2F 






EB 18 49 GE 63 6F 72 72-65 63 74 20 44 4F 53 20 k.Incorrect DOS 
76 65 72 73 69 6F GE OD-OA 24 SO B4 30 CD 21 86 
EO 3D 36 01 72 OS 3D OA-02 76 09 BA O02 O01 B4 09 ‘#6.r.8..v.:..4. 






version..@P40N!. 









MIM Xk/ O 





HOO100: JMP Short HOO11A 300100 EBi8 phe 
i A Die we a ey a aa Bee anes fms ob shelf wa nw gn vw nina. ed, 
O DB “Incorrect DOS version" 300102 496E636F727265 O 
DB ODh 300117 
DB OAh 300118 
O DB ogee 300119 24 O 
HOO11A: PUSH AX 30011A SO 
O MOV AH, 30h 3;0011B B430 _o O 
INT 2ih 3i1-DOS_Ver_Number 3s0011D CD21 $ 
XCHG AH, AL ;0011F 86E0 ae 
CMP AX,0136h 300121 3D3601 =6_ 
O JB TR eras ee FL le on Be og 300124 7205 a O 
CMP AX,O20Ah . 300126 3DOA02 = 
JBE BRONCO ME ie el PLS AS) Bec at did he oe amend lee 300129 7609 a 
O HOO12B: MOV DX ,0102h 3;0012B BAO201 ag O 
MOV AH,O9h ;0012E B409 Ry 
INT 2ih 31-Display_ String 300130 CD21 Be. 
INT 20h ;TERM_normelly:20h ;00132 CD20 3 
O TEGAN ak Es COIS Peake ak tices Sea ar ete shy ite ‘ O 
HOO134: POP AX 300134 58 xX 
JMP Short HOO166 300135 EB2F Ry 
O ; O 
MNASTER*KEY XREF - PROGRAN.XRF Page i 
O O 
0102h £74 2F5 301 320 
O20Ah 126 
O3CBh 12B 
O i-Display_ String 1390 S91 6190 
1-DOS_Ver_Nunmber 11D 
HOO100 100 
O HOO11A 100 11A 
HOO12B 124 12B 
HOO134 129 134 
HOO166 i135 
O TERM_normally:20h 132 


step by step to: 


9. Make software more compatible with your 
computer. Be certain a questionable program 
won't damage your system BEFORE you runit. 


6. Modify software to operate with other 
versions of DOS. 


7. Customize your COMMAND.COM or other 


executable program directly or by reassem- 
bling your altered MASTER*«KEY source code. 


MASTER * KEY should not be confused with any public 
domain or share ware software that may have a 
similar name or be a similar product. 
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(not copy protected) 


Phone orders accepted on MC or VISA 


$82.45 (includes $2.50 shipping) 
$87.65 in California (includes tax & 
shipping) C€.0.D. orders add $2.00 


(714) 596-0070 


Please send MASTER*« KEY! 


Send checks to: 


Sharpe Systems Corporation 
2320 E Street, Dept. 44, La Verne, CA 91750 


Order Now! 
Just $7995 


Name 
Address 
City 


State Zip 


PROGRAMMER’S SERVICES 


OF INTEREST : 





Object-Oriented 
Programming 

Productivity Products Interna- 
tional is offering an object-oriented 
software engineering environment 
that contains Objective-C, Vici, and 
a catalog of Software-ICs. Objective- 
C is an object-oriented sofware engi- 
neering language that includes such 
features as encapsulation, which 
holds data within an object and sur- 
rounds the data with a shell of pro- 
cedures; inheritance, which builds 
and reuses code; and dynamic bind- 
ing, which allows Objective-C ob- 
jects to decide at run time which 
routine to run. Vici is a prototyping 
and debugging environment. Soft- 
ware-ICs are modules of reusable 
code that give programmers the 
same advantages as integrated cir- 
cuits give hardware designers. 

The PPI product set is available 
for the DEC VAX, Sun Microsystems, 
HP-9000, and Apollo lines and the 
IBM PC AT. Source code licenses are 
available for users who want to port 
the environment to their own pro- 
prietary hardware. Reader Service 
No. 16. 

Productivity Products International 
Inc. 

27 Glen Rd. 

Sandy Hook, CT 06482 

(203) 426-1875 


A new programming product for the 
Macintosh is available from Coral 
Software. Object Logo features object- 
oriented programming tools, an in- 
terpreter for interactive debugging, 
a compiler that automatically trans- 
lates each procedure into native 
code, a user interface that conforms 
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to the Macintosh standards, com- 
plex and rational arithmetic, arrays, 
Macintosh ROM support, and a vari- 
ety of advanced primitives: and de- 
bugging tools. Object Logo is avail- 
able for the Macintosh 512, 512E, 
Plus, and SE and costs $79.95. 
Reader Service No. 17. 

Coral Software 

P.O. Box 307 

Cambridge, MA 02142 

(617) 547-2662 


Languages 

A Modula-2 language systems is now 
available from ana-systems. Modula- 
2/68 is suitable for professional soft- 
ware development or academic in- 
struction on systems using the Mo- 
torola line of 32-bit microprocessors. 
With Modula-2/68, program modules 
can be compiled separately. An 
executable process can be built by 
linking with previously compiled pro- 
gram modules or by linking with 
library procedures written in C. 
Modula-2 programs can _ easily 
access standard C object libraries, 
which means that modules can use 
previously written and debugged sub- 
routine libraries written in other pro- 
gramming languages. For special ap- 
plications based on the MC68000 
processor line, the linked Modula-2 
programs can be written out in the 
Motorola S-record format and then 
easily downloaded to standard de- 
velopment systems. 

Modula-2/68 is available for the 
Convergent Technologies line of 
Unix systems and sells for $1,200. 
Reader Service No. 18. 
ana-systems 
697 Saturn Ct. 

P.O. Box 4759 
Foster City, CA 94404-0759 
(415) 341-1768 


WATCOM has announced two new 
C language products for IBM PC and 
PS/2 DOS systems. WATCOM C 6.0 is 
an optimizing compiler that comes 
with a full range of programming 
tools, including a windowed source- 
level debugger. WATCOM Express C 
provides an integrated development 
environment, including an editor, 
compiler, debugger, and run-time li- 
brary that are all memory-resident. 











Programs may be compiled in 
memory and then executed directly 
without separate link and load 
steps. Reader Service No. 19. 
WATCOM Products Inc. 

415 Phillip St. 

Waterloo, Ont. 

Canada N2L 3X2 

(519) 886-3700 


C Workshop from Wordcrait is a 
program that teaches C. It also con- 
tains a programming environment 
that users can use for experiment- 
ing, prototyping, and developing the 
modules for any programming pro- 
ject. C Workshop contains a full stan- 
dard K & R compiler, an editor, a 
run-time library, tutorial software, 
and a book. The software uses 220K 
and runs on 320K MS-DOS comput- 
ers with industry-standard BIOS. 
The package sells for $69.95. Reader 
Service No. 20. 

Wordcraft 

3827 Penniman Ave. 

Oakland, CA 94619 

(800) 227-2400 


PL/D from Dair Computer Systems 
is a new system language that allows 
users the speed and control of as- 
sembly language with the ease of 
expression of a compiler. Like as- 
sembly language, PL/D has no run- 
time library overhead. PL/D code is 
inherently capable of relocation for 
EPROM-based embedded control, a 
common PL/D application. Features 
of the language include macro and 
conditional compile facilities, library 
functions that can be incorporated 
into the program at compile time as 
SYS source files, 17 options that can 
be specified within the source, and 
some features similar to Forth and 
C. Source code of the compiler is 
available. PL/D requires a 192K IBM 
PC AT or PC/XT with MS-DOS 2.0 or 
later and sells for $124.95. Reader 


‘Service No. 21. 


Dair Computer Systems 
3440 Kenneth Dr. 

Palo Alto, CA 94303 
(415) 494-7081 


Fun Stuff 


If you are tired of programming and 
want to get out of the house, Ex- 
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panded Entertainment has released 
a new film that compiles some of 
the top shorts in computer anima- 
tion in The Computer Animation 
Show. The show is a collection of 
3-D character animation, abstract 
work, corporate show reels, experi- 
mental animation, and _= several 
ground-breaking music videos. The 
show is presented in 35 millimeter 
and charts the growth of computer 
graphics over the last five years. The 
movie debuts in 400 cities nation- 
wide throughout 1988. Reader Serv- 
ice NO; 22. 

Expanded Entertainment 

2222 S. Barrington Ave. 

Los Angeles, CA 90064 

(213) 473-6701 


Hardware 

RasterOps Corp. has introduced a 
high-resolution color graphics board 
for the Macintosh II. The ColorBoard 
1/104 features a single-slot design, 
true color capabilities, and 
1,024 X 768 pixels on a 24-bit color 
plane capable of displaying 16.7 mil- 
lion colors simultaneously. The Color- 








Board 1/104 is priced at $2,795 and 
runs on the Macintosh II. Reader 
Service No. 23. 

RasterOps Corp. 

10161 Bubb Rd. 

Cupertino, CA 95014 

(408) 446-4090 


The EVERCOM II 24 is a 2,400-bps 
modem for the IBM PS/2 with Micro 
Channel architecture. Available from 
Everex, this modem features state- 
of-the-art signal processing and adap- 
tive equalization, auto-dial, auto- 
answer, auto-speed-matching to the 
calling modem, and auto-sense of 
tone/pulse dialing. Users can easily 
switch from voice to data and data 
to voice during a call. Built-in intelli- 
gence can detect and respond to 
such variables as transmission speed 
and data format. International com- 
patibility is supplied by incorporat- 
ing Hayes, Bell 212A/103, CCITT V.22, 
and V.22 bis protocol standards. 
BitCom, a menu-driven communica- 
tions program is also included. The 
EVERCOM II 24 is priced at $299. 
Reader Service No. 24. 





"Dick Johnson 


in accounting 
having a 
heart attack!” 








Would you know what to do? 


Would anyone in your company be 


able to help? 











Announcing 
WKS LIBRARY _NEW! 


The Lotus ‘‘Wrap-Around”’ for C Programs 


Now you can write and read Lotus worksheets 
directly from a C program! 
WKS LIBRARY lets you: 
*¢ avoid time-consuming file translation steps 
* control the execution of 1-2-3 from inside your application 


* use Lotus as a data entry screen in your C program 
© generate ‘‘live’’ financial statements with formulas for totals 


Everex 

48431 Malndodit Dr. 
Fremont, CA 94538 
(415) 498-1111 


DigiBoard has introduced the 
OpenEnder, a multichannel board 
for the PS/2. The OpenEnder fea- 
tures DigiBoard’s modular I/O con- 
cept, the YO Mate. The I/O Mate 
contains [I/O components and 
mounts to the OpenEnder portion 
of the board that holds the proces- 
sor and memory. I/O Mates are avail- 
able in both 4- and 8-port configura- 
tions with an added synchronous 
channel available on the I/O Mate + 
series. The OpenEnder features an 
on-board 80186 microprocessor op- 
erating at 12 MHz, 256K of dual- 
ported RAM, and up to 64K of ROM 
to store user-defined programs. The 
OpenEnder is compatible with MS- 
DOS and Xenix and will support 
other operating systems. List prices 
are $1,349 with I/O Mate-8, $1,399 
with VO Mate8+, $1,149 with VO 
Mate-4, and $1,199 for /O Mate4+. 
Reader Service No. 25. 













Feature this: 

¢ reads and writes .WKS, .WK1 and .WR1 worksheets 

* writes integers, floats, strings, formulas, macros and dates 
using wprintf{() 

* reads using wscanf(), converting column contents to C 
variables according to format specs 

* has low-level functions for manipulating individual cells 

¢ provides Lotus control functions such as: 
formats, column widths, initial cursor position, range 
names, cell protection 


* supports Lattice, Microsoft & Turbo compilers for DOS, plus 
most UNIX environments 


Source Code provided No Royalties on executable programs 


Only $89 ORDER TODAY! 


(includes free Toll-free 
800-line support) (800) 367-9882 


Ad Pz Tenon Software, Inc. 


One of your employees is stricken. 
Breathing and heartbeat have stopped. 
Does anyone know what to do until help 
arrives? 

The American Red Cross can 
train your employees in CPR—Cardio- 
pulmonary Resuscitation, a first aid 
method that sustains life. 

It's just one of the ways the 
Red Cross helps you keep your company 
healthy and safe. 

Contact your local Red Cross 
Chapter and ask about CPR training. 
That way, when disaster strikes, you can 
all breathe a litle easier. 













—— 
VISA 
aE 


——EEE) 











“ae American Red Cross 
1980 - 112th NE, #250, Bellevue, WA 98004 
(206) 453-1914 (in Washington state) 
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OF INTEREST 
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DigiBoard Inc. 

6751 Oxford St. 

St. Louis Park, MN 55426 
(612) 922-8055 


Kinetic Access is a security product 
from Kinetic Corp. that offers micro 
system security through an easy-to- 
use program. The total system in- 
cludes a hardware device that con- 
trols the booting process and a resi- 
dent control program that requires 
45K RAM while in operation. The 
hardware device can be either an 
EPROM, which fits into an available 
ROM socket, or a short expansion 
card that plugs into any available 
slot on the PC. After installation of 
Kinetic Access, every time the 
system is booted up, Kinetic Access 
password protects users’ files and 
applications. Kinetic Access is avail- 
able for users of IBM PC, XT, AT, and 
true compatibles operating with MS- 
DOS, Versions 2.x or 3.x. The prod- 
uct is priced at $129.95 per unit with 
EPROM and $149.95 per unit with 
short expansion board. Reader Serv- 
ice No. 26. 








Kinetic Corp. 

Distillery Commons 240 
Lexington Rd. @ Payne 
Louisville, KY 40206-1990 
(502) 583-1679 


Tools and Utilities 

A data-compression package has 
been released by Isogon Corp. 
NEWSPACE is a RAM-resident utility 
that significantly increases the stor- 
age capacity of any IBM or IBM- 
compatible PC hard disk. The pro- 
gram automatically and _ transpar- 
ently compresses word processing, 
spreadsheet, database, and all other 
kinds of data files without any user 
involvement. Although the kind of 
compression achieved depends on 
the nature of the data, 50 percent 
overall compression is average. NEWS- 
PACE operates with all application 
programs and RAM-resident utilities 
and works on all PC-DOS and MS- 
DOS machines running Version 2.0 
or later, including the PS/2. The pro- 
gram sells for $69.95. Reader Service 
No. 27. 

Isogon Corp. 








330 Seventh Ave. 
New York, NY 10001 
(212) 967-2424 


Quinn-Curtis has announced Sci- 
ence and Engineering Tools for the 
Macintosh 512K or bigger. The pack- 
age includes procedures for general 
statistics, multiple regression, curve 
fitting, integration, FFTs, solving dif- 
ferential and simultaneous equa- 
tions, matrix math, complex math, 
data smoothing, linear program- 
ming, root finding, and special func- 
tions. A 160-page manual describes 
the form, function, and parameters 
of every procedure and function. All 
the software tools are supplied on a 
3.5-inch disk in both Lightspeed 
Pascal and Turbo Pascal source 
code. The Science and Engineering 
Tools package retails for $74.95. 
Reader Service No. 28. 

Quinn-Curtis 

49 Highland Ave. 

Needham, MA 02194 

(617) 444-7721 


DDJ 


ADD TO THE POWER OF YOUR PROGRAMS WHILE YOU SAVE TIME AND MONEY! 


CBTREE does it all! Your best value in a B+tree source! 


Save programming time and effort. 


You can develop exciting file access programs quickly and easily because 
CBTREE provides a simple but powerful program interface to all B+tree 
operations. Every aspect of CBTREE is covered thoroughly in the 80 page 
Users Manual with complete examples. Sample programs are provided on 


disk. 


Gain flexibility in designing your applications. 
CBTREE lets you use multiple keys, variable key lengths, concatenated 
keys, and any data record size and record length. You can customize the 


B+tree parameters using utilities provided. 


Your programs will be using the most efficient searching techniques. 
CBTREE provides the fastest keyed file access performance, 


: Get first 

* Get previous 

* Get less than 

* Get greater than 

* Get sequential block 

* Get all partial matches 
* Insert key and record 
* Delete key and record 


* Change record location 


with multiple indexes in a single file and crash recovery utilities. 


CBTREE is a full function implementation of the industry 
standard B+tree access method and is proven in applications 


since 1984. 





Access any record or group of records by: 


* Get last 

* Get next 

* Get less than or equal 

* Get greater than or equal 
* Get partial key match 

* Get all keys and locations 
° Insert key 


* Delete key 


Increase your implementation productivity. 
CBTREE is over 8,000 lines of tightly written, commented C source code. 
The driver module is only 20K and links into your programs. 


Port your applications to other machine environments. 
The C source code that you receive can be compiled on all popular C 
compilers for the IBM PC and also under Unix, Xenix, and AmigaDos! No 


royalties on your applications that use CBTREE. CBTREE supports multi- 
user and network applications. 


CBTREE IS TROUBLE-FREE, BUT IF YOU NEED HELP WE PROVIDE FREE PHONE SUPPORT. 
ONE CALL GETS YOU THE ANSWER TO ANY QUESTION! 


OR WRITE 


CBTREE compares favorably with other software selling at 2,3 and 4 times our price. 
Sold on unconditional money-back guarantee. 
YOU PAY ONLY $159- A MONEY-SAVING PRICE! 
TO ORDER OR FOR ADDITIONAL INFORMATION 
CALL 1-800-346-8038 or (703) 847-1743 


NOW! Variable length records. 


NEW! --- Limited Time Offer. 
Object Library for Only $49! 


Peacock Systems, Inc., 2108-C Gallows Road, Vienna, VA 22180 
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C CODE FOR THE PC 


source code, of course 
C Source Code 


Bluestreak Plus Communications (two ports, programmer’s interface, terminal emulation) $400 
CQL Query System (SQL retrievals plus windows) .............0.228 04 $325 
GraphiC 4.1 (high-resolution, DISSPLA-style scientific plots in color & hardcopy) et ee ee $325 
Barcode Generator (specify Code 39 (alphanumeric), Interleaved 2 of 5 (numeric), or UPC) $300 
Greenleaf Data Windows (windows, menus, data entry, interactive form design)... . . . $295 
RNR RMN ERIAIIWIEY 2) yh gs Ua dcp gee TS Me ak lage te tS etd te $200 
recident C (TSRify C programs, DOS shared libraries)’. 2 2 0s bo ee we $165 
Essential C Utility Library (400 useful C functions) . . . $160 
Essential Communications Library (C functions for RS- 232-based communication systems) $160 
Greenleaf Communications Library (interrupt mode, modem control, ore $150 
Greenleaf Functions (296 useful C functions, all DOS services) . a ; $150 
OS/88 (U**x-like O/S, many tools, cross-development from MS-DOS) . . $150 
Turbo G Graphics Library (all popular adapters, hidden line ni $135 
CBTree (B+tree ISAM driver, multiple variable-length keys) ao BV Bus $115 
MultiDOS Plus (DOS-based multitasking, intertask messaging, semaphores) $115 
PC/IP (CMU/MIT TCP/IP implementation for PCs) . . Nie: SS $100 
B-Tree Library & ISAM Driver (file system utilities by Softfocus) bak ees SEA tee $100 
The Profiler (program execution profile tool) . ........ EE ied adie $100 
Entelekon C Function Library (screen, graphics, keyboard, string, printer, ‘etc. ) gee Nae ge srg Sah $100 
Entelekon Power Windows (menus, overlays, messages, alarms, file handling, etc. ).. $100 
Wendin O/S Construction Kit or PCNX, PCVMS O/S Shells. . . $95 
QC88& C Compiler (ASM output, small model, no longs, floats or bit halide. 80+ fiinction library) $90 
JATE Async Terminal Emulator (includes file transfer and menu subsystem) Pree s a steeene $80 
MultiDOS Plus (DOS-based multitasking, intertask messaging, semaphores) $80 
ME (programmer’s editor with C-like macro language by Magma ‘gene $75 
WKS Library (C program interface to Lotus 1-2-3 program & gi $65 
Quincy (interactive C interpreter). ........... $60 
EZ_ASM (assembly language macros bridging | C and eis $60 
PTree (parse tree management). ............0%.. $60 
HELP (pop-up help system builder)... .......2... $50 
Multi-User BBS (chat, mail, menus, sysop displays; uses Galacticomm modem card) . $50 
Heap Expander (dynamic memory manager for expanded memory) ....... $50 
Make (macros, all languages, built-in rules) ............... ys $50 
Vector-to-Raster Conversion (stroke letters & Tektronix 4010 codes to bitmaps) $50 
Coder’s Prolog (inference engine for use with C programs) . oe Seek eb aye ea ee $45 
C-Help (pop-up help for C programmers ... add your own notes) $40 
Biggerstaff’s System Tools (multi-tasking window manager kit) . . $40 
CLIPS (rule-based expert system generator, Version 4.0) $35 
TELE Kernel (Ken Berry’s multi-tasking kernel) . .. ..........00020084 $30 
TELE Windows (Ken Berry’s window package)... . . . ; $30 
Clisp (Lisp interpreter with extensive internals documentation) ' et ene ene $30 
Translate Rules to C (YACC-like function generator for rule-based systems) eh eee dade A $30 
6-Pack of Editors (six public domain editors for use, study & hacking). ......... $30 
ICON (string and list processing language, Version 6 and pees) GY oe" el Keres am lal Se ; $25 
Tete (CRIA) GNOIUWEE BOGUT MEE girl me yc ony dale? Wilescee eae: 4.1 <8 a vo a Oe BORSA $25 
Bison & PREP (YACC workalike parser generator & attribute grammar r preprocessor) . $25 
AutoTrace (program tracer and memory trasher catcher) $25 
C Compiler Torture Test (checks a C compiler against K & R) $20 
Benchmark Package (C compiler, PC hardware, and Unix system) . . ; $20 
TN3270 (remote login to IBM VM/CMS as a 3270 terminal on a 3274 4 controller) $20 
iNOS: (68000 cross-assemiDler) 6. 5 ee fa ace tg et es vg | DS a a $20 
List-Pac (C functions for lists, stacks, and queues) Se dere te EES oat Rat he. A a” $20 
XLT Macro Processor (general purpose text translator) i a aes ne oe Rey ae aa $20 
C Tools (exception macros, wc, pp, roff, grep, printf, hash, declare, ‘banner, Pascal-to-C) 543 $15 
Data 

WordCruncher (text retrieval & document analysis program) . . $275 
DNA Sequences (GenBank 48.0 of 10,913 sequences with fast similarity ‘search program) . $150 
Protein Sequences (5,415 sequences, 1 302,966 residuals, with similarity search program . $60 
Webster’s Second Dictionary (234,932 ceeenais} ye gi rege Bar Ss eg ava OO 
U. S. Cities (names & longitude/latitude of 32,000 U.S. cities and 6 000 state boundary points) Ligh y Se 
The World Digitized (100,000 longitude [latitude of world country boundaries) ; $30 
KST Fonts (13,200 characters in 139 mixed fonts: specify TEX or bitmap format) . $30 
USNO Floppy Almanac (high-precision moon, sun, planet & star positions) . $20 
NBS Hershey Fonts (1,377 stroke characters in 14 fonts) ar i ee A $15 
U. S. Map (15,701 points of state boundaries) ...... tebeaa pein 4 
The Austin Code Works Voice: (548) 258-0785 
11100 Leafwood Lane BBS: (512) 258-8881 
Austin, Texas 78750-8409 USA acwlinfoQuunet.uu.net FidoNet: 1:882/12 
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Upgrade Your Technology 


We’re Programmer’s Connection, the leading 
independent dealer of quality programmer’s 


USA........ 800-336-1166 


development tools for IBM personal com- Canada aucsudestocccucevectosestscatasecausceeves 800-225-1166 
. Ohio & Alaska (Collect) .................. 216-494-3781 
puters and compatibles. We can help You internationals 216-494-3781 


upgrade your programming technology with TELEX 
some of the best software tools available. 
Comprehensive Buyer’s Guide. The CONNECTION, 
our new Buyers Guide, contains prices and up-to-date 
descriptions of over 600 programmer's development 
tools by over 200 manufacturers. Each description 
covers major product features as well as special re- 
quirements, version numbers, diskette sizes, and 
guarantees. 

How to Get Your FREE Copy: 1) Use the reader ser- 
vice card provided by this journal; 2) Mail us a card 
or letter with your name and address; or 3) Call one 
of our convenient toll free telephone numbers. 


If you haven’t yet received your copy of the 
Programmer’s Connection Buyer’s Guide, act 
now. Upgrading your programming technol- 
ogy could be one of the wisest and most 
profitable decisions you'll ever make. 


Jnitbuiad cakes bacesiabeincnt ioDlaighsdaeagi 9102406879 


Business Hours: 8:30 AM to 8:00 PM EST Monday through Friday 
Prices, Terms and Conditions are subject to change. 
Copyright 1988 Programmer's Connection Incorporated 


Sale Prices effective through 03/31/88 





: II 28 er ican a ekeihenstincans 100 64 
386 products it Cas. eet 100 «BA 
386 ASM/386 LINK Cross Asm by Phar Lap ..........000+: 495 389 Turbo Basic Database Toolbox .....................----. 100 64 
386 DEBUG Cross Debugger by Phar Lap .............200++: 195 129 Turbo Basic Editor ToOIbOX ..............cccsceeceeeneeene . 100 64 
NDP C-386 by MicroWay .............cccceecteeeteeeeees New 595 529 Turbo Basic Telecom Toolbox .......................... 100 ~=«é6 4 
NDP ForTran-386 by MicroWay...............0.c000000 New 595 529 Turbo C Compiler (Cai! for support products)............. 100 «=—«64 
PC-MOS/386 Single-User by The Software Link............ 195 155 Tb oe cn 100 «64 
PC-MOS/386 5-Users by The Software Link ............0.0 595 539 Turbo Lightning Word Wizard... 70 «(47 
PC-MOS/386 25-Users by The Software Link............... 995 869 Cy ee Sae 10 59 
—— Turbo Pascal Database Toolbox 00.0... 100 64 
OPTASM Turbo Pascal Developer's Toolkit ..............0........ . 6 BB 
List $195 Ours $179 Sale $159 ee ee pea 
OPTASM is a high performance macro assembler which is com- Turbo Pascal Graphix Toolbox... 100 «64 
patible with the Microsoft Macro Assembler 5.0 (except for Turbo Pascal Numerical Methods Toolbox... 100 «6A 
80386 support). It provides many advanced features aS Well Turbo Pascal TutOr.....-cccccccsccscseeesseeeee. ‘70 41 
as speed that’s four times faster than MASM. And utilizing the Turbo Prolog Compiler ...................cc.cs0sssceeeeeeeeeeoee- 100 64 
built-in make utility can increase this speed to 10 times! OP- Turbo Prolog TOOMDOX ...............ccccccesceceseseeeeseeeeeeees 100 64 
TASM eliminates most of the problems with using MASM. It ec lan 
generates correct code in all forward reference cases that : : guage 
cause phase errors in MASM. OPTASM is one of the fastest  ©00-C88 Modeling Compiler by Ecosoft............. Sale 100 69 
MASM-compatible assemblers available. Lattice © Compiler vers. 3.2 from Lattic€................00. 500 265 
Optimum -C by Datalight .............ccceccsescseeseseeeeeeeeee 139s 95 
ave oo eh Peabody Pop-Up Reference Utility 
Tree Diagrammer by Aldebaran LabS ..........cccccccccsesees 7 38 by Copia International 
oo Peabody is a fast and flexible on-line reference utility with 
he Bocas a nde ga ae ae . databases available for Turbo Pascal or Microsoft C. It provides 
WANIIERN 2 cist hn aceaee as New 200 185 hia sede 7 uk i ee i in ben 0p 
rames at the touch of a key. With Peabody, you can select 
assembly language general topics from a structured subject menu, or use 
Cross Assemblers Various by 2500 AD.............:.::100 CALL CALL Peabody's hyperkey to get instant help for the keyword closest 
OPM a Soe ecu Software ee Ss bs to the cursor. Specify database desired. Additional databases 
AG Ge oo i ee ea ea New, Sale 80 59 BES SUA OEE OOS COE Net OF SO NOIR TaN. 2 
blaise products c utilities 
ASYNCH MANAGER Specify C or Pascal..........c00000.-. 175 135 C++ Dy Guidelines .........c.cccccceeceeeeeeeeeees New Version 295 259 
POOLS PESO. 6 ic) dh ee 129 99 C Programmer's Toolbox | by MMC AD.............. New 80 69 
KeyPlayer Super Batch Program ......scc..scesssseessvecssvees 5045 C Programmer's Toolbox Il by MMC AD............. New 80 69 
LIGHT TOOLS for Datalight C ........cccccssssssssveeeeee Sale 100 55 C Programmer's Toolbox Combo by MMC AD....New 130 115 
PRASGAE TORR SIIOULS 2 2s cscssssvscedsceecscchsaseeose 175 135 C-SCAPe Dy Oakiand GIOUP «..........esscecsseeseerserseeen New 279 265 
RUNOFF Text Formatter .........c.csccssssscscsssecssssvesenseceen 5045 c-tree & r-tree Combo Dy FairCOM ............cecssseeeonees 650 519 
Turbo ASYNCH PLUS/4.0 ooo... cccccccccccscesseeseeseesee 129 99 C-tree (SAM File Manager .........s.ssecseersesecseeseesees 395 315 
MONT Nooo ocd dstiu inne Wek nauk 129 99 F-tree Report GENCLAtOL ............ssseesseesseeesnessneensees 295 239 
Turbo POWER TOOLS PLUS/4.0.00000......ccccccecseeeen 129. 99 CBTREE by Peacock SYStems.............0-0s00 New, Sale 159 119 
VIEW MANAGER Specify C or PasCal .......c.0...sce0000+ee- 275 «199 59 nda hss ae Sve: Gales hires New 395 ~ 
urses Window Dev Db en Scientific ....... Sale 119 
borland products sind cnet delta 5s ee ae Sale 289 235 
EUREKA Equation SOWEP ..........ccccccccccsscsesstessesrseeees 167 105 dBx OBASE to C Translator by Desktop Al.............0:0c000+. 350 299 
Paradox 1.1 Dy AnSa/Bonand ......c.ccccccccccccscscscescseesees 495 359 A GNNCO CO ie sie ssnssivcsecessocsacsevacsinoains 550 419 
Paradox 2.0 by Ansa/Bonand ...........ccccceccsessesesssveseee 725 525 DMS Resident-C by American Software Intl .........0.0.0.. 150 139 
Paradox Network Pack by Ansa/Borland...............c0000 995 725 Entelekon Combo Package ...................... Clearance 200 99 
Quattro: The Professional Spreadsheet............ New 195 125 Flash-up by Software Bottling...........cccccccccccecesseseeeee 89 79 
Reflex: 2, Re Sa arene i ier a eRe 150 99 HALO Graphics by Media Cybemetics...........c.cccccccceceeee 300 205 
Teh aR bin ER RIN MT ANE CE TERI a 8 57 HALO Development Pkg for Microsoft .............c.c0000- 595 389 
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ORDERING INFORMATION 


FREE SHIPPING. Orders within the USA (including 
Alaska & Hawaii) are shipped FREE via UPS. Call for 
express shipping rates. 

NO CREDIT CARD CHARGE. VISA, MasterCard and 
Discover Card are accepted at no extra cost. Your card 
is charged when your order is shipped. Mail orders 
please include expiration date and authorized signa- 
ture. 

NO COD OR PO FEE. CODs and Purchase Orders are 
accepted at no extra cost. No personal checks are ac- 
cepted on COD orders. POs with net 30-day terms 
(with initial minimum order of $100) are available to 
qualified US accounts only. 

NO SALES TAX. Orders outside of Ohio are not 
charged sales tax. Ohio customers please add 5% Ohio 
tax or provide proof of tax-exemption. 

30-DAY GUARANTEE. Most of our products come 
with a 30-day documentation evaluation period or a 30- 
day return guarantee. Please note that some manufac- 
turers restrict us from offering guarantees on their 
products. Call for more information. 

SOUND ADVICE. Our knowledgeable technical staff 
can answer technical questions, assist in comparing 
products and send you detailed product information 
tailored to your needs. 

INTERNATIONAL ORDERS. Shipping charges for In- 
ternational and Canadian orders are based on the ship- 
ping carrier's standard rate. Since rates vary between 
carriers, please call or write for the exact cost. Inter- 
national orders (except Canada), please include an ad- 
ditional $10 for export preparation. All payments must 
be made with US funds drawn on a US bank. Please 
include your telephone number when ordering by mail. 
Due to government regulations, we cannot ship to all 
countries. 

MAIL ORDERS. Please include your telephone num- 
ber on all mail orders. Be sure to specify computer, 
Operating system, diskette size, and any applicable 
compiler or hardware interface(s). Send mail orders 
to: 


Programmer’s Connection 
Order Processing Department 
7249 Whipple Ave NW 
North Canton, OH 44720 


List $149 Ours $125 Sale $99 


PANEL by Rounchil, Spec#y Quick or Turbo C 129 = 95 
PANEL Plus by Roundh 495 395 
RTC PLUS Fortan to C by Cobalt Bue . 450 369 
Sapiens V8 Virtual Memory Manager . 300 265 
TE Developer's Kit by Sub Systems __.... 9 85 
Vitamin C by Creative Programming ....... 225 149 

VC Screen Forms Designer........... 100 «3s 79 
WKS LIBRARY by Tenon Software .......... so 6=s 79 

database management 
Clipper by Nantucket... 69 379 
GBASE Ill Plus by Ashton-Tate 695 389 
dB2c FILES by Software Connection ........ New 193 179 
dB2c TOOLKIT by Software Connection............... New 299 249 
dB2c WINDOWS by Software Connection ............ New 99 89 
ob | SR cal a oa 149 «+119 
Fox Base Plus by Fox Software ......ccccccsccssssescseeesseees 395 249 
COINS By BYE cin cases beecca stash de codvaraetsncrenecn 395 249 
es We DY ANI i ion cscscsuitsegnsieaiutipoereeea tt vensh 199 179 
COOMA boy Sporn tn ey ci ee Sica oaks 349 219 
R:Base 5000 by MiCrOIM ........c.cccccceeet cece eeeeeeseees 495 359 
R:Base System V by MICMONM. ............6.c.c0cccseecesenes 700 439 
Ul Programmer by WallSOft..........0.ccccccccccccesecseseseees 295 239 
ASMLIB 
by BCSoft 


ASMLIB contains over 210 functions all easily accessible by a 
single CALL from within your assembler or high level language 
program. It features: access to keyboard, screen, disk files, 
EGA, CGA & Hercules adapters; windowing with overlapping 
windows; math and trig functions for four different data types; 
8087 support, dynamic memory management; virtual disk file 
handling; and much more. Includes complete source code. 
Supports Microsoft C, Fortran, MASM, and Pascal. 


debuggers 
Periscope | with Board by Periscope ..............0...0.00008 345 275 
Periscope Il with NMI Breakout Switch ..............0.0c000+. 175 139 
Periscope II-X Software OM ..........cccccccccccssssesseseseees 145 105 
Periscope Ill 8 MHZ VerSION.............c.c0ccccccescseseeseeeeee 995 795 
Periscope Ill 10 MHZ VerSiON ............ccccccccesssesseceseeee 1095 875 
digitalk products 
Smalltalk/V by Digitalk..........ccccccccccscssssecsssecsssessseeee 100 84 
EGA/VGA Color Option 00.0... cccccccceeecceeeaee 50 «4 
Goodies Diskette 41 ooo... ccccccccccsceeeeseeseen 50 45 

















Goodies Diskette #2 «0.000.000... New 50 


Goodies Diskette 43 00.0.0... New 50 
Smalltalk/Comm ..........0..cccccccccescessesesseeseeseeseens 50 
dos utilities 
Desqview from Quarterdeck ..........cccccccccscsesesesescsesees 130 
Mace Utilities Pau/ Mace Software ..........cccccseseseeeees 99 
XO-SHELL by Wyte Corporation ............ccceceseeeee: New 49 
essential products 
Breakout Debugger by Essential Software.................. 125 
MN eGo cds culeznpsssickeen cncdtnngesenieds 185 
Essential Communications....................0...:00cc0e 185 
Essential Communications with Break Out................ 250 
ST PC ee 250 
MN ain cs nc cplenstasanancieasophigenoanentttcr 99 
SP MEE A asta os sca sscitas wad vaddvasienss raaninteanpeate 198 
oo eek Sol She See eh an ee er OE 99 
WT LID Cary SOURCE COR «is. ..scsnccqussesisseersssscsseecess 198 
fortran language 
FRMPETEIES Dy SUGASINT 55. <<, ovapco-scoanrcantcusoraeeboaps Sale 125 
CRE AT |) a ee Sale 175 
HALO Graphics by Media CybeMetics............ccccceecees 300 
INGRAF by Sutrasoff...........cccccccceeeeeens New, Sale 250 
Numerical Analyst by MAGUS ...........ccc00ssssseesssseeen 295 
PEPE NRINAINT oi i cscssnavacdecsesspciosieasonnsobaest Sale 175 
PETIT OP UIE AEAN Geo scicancsnacevsssnteonsosjocessnstisecs Sale 175 
gimpel products 
C-terp by Gimpel, Specify COMPIIET.............:00c08 Sale 298 
BU IMINO i. Capns ox ahop saieds choad osadntysaceaonshoants Sale 498 
PC Lint by Gimpel SOftWare .............ccccccceccseesteeneenenes 139 
Turbo C-terp for Turbo C by Gimpel............4.. NewSale 139 


Flash-Up with FREE Mouse 
from Software Bottling of NY 
List $89 Ours $79 


Flash-Up is a memory-resident macro, menu and note maker 
compatible with most languages. Easy-to-use features include 
a pull-down interface and on-line help. And until 03/31/88, 


you'll also get a Microsoft compatible mouse FREE. 


golden bow products 


CMI isi (evs fuscks wvcin sete bein Spa trove octave biccie 50 
MN cj xctiocsleligs cil nike haaptesinciaah aks ins 80 
DS INNO aida ccc ta ecutsvadnschacdsnioanrndenioesvee 120 
A Boe SID Ee A ar Aen CE em 50 
greenleaf products 
Greenleaf C Sampler specify QuickC or Turbo C.......... 95 
Greenleaf Comm Library ..................cc:ccceereees 185 
Greenleaf Data Windows Library ....................0... 225 
WIRE 6 coycdsucdeevtaieasgancenioradennrsitigeses 395 
Greenleaf Functions .....................ccccccceceteteneeeees 185 
komputerwerk products 
Finally by KOMpUtCIWEDK ..........ssescsseseseeseseeessseeteneess 99 
Finally Modules by Komputerwerk ...........10000000 New 99 
Finally XGraf by Komputerwerm............1seeeee New 99 
lattice products 
Lattice C Compiler ver 3.2 from Lattice ...........ccceseees 500 
With Library SOUPCE CODE ..........csvescseersesessecersees 900 
C Cross Reference Generator ................0::c0cees 50 
C-Food Smorgasbord Function Library ..........:0cecee0e 150 
WIT SOCEM Sacscs ps esate eanddys ese dattonogeadanss 300 
C-Sprite Source Level DEDUQQES...........::ceeeereseeeeen 175 
Curses Screen Manager .......c.ccccccceceseseseteneeetenseeee 125 
ES SEE oh ee ACD 250 
IN gn eee ie SNE naman shares ERS Aan 250 
MN ONE CANN 2 ase ssscssecectuas ly atnaetearae nas 500 
NN os ok esis nec Rcaseleacteaddonnen she 750 
OT SMT Lo si hciesssveandeteTaavesitvaontices. 1500 
SO TINE GB sec cpepssen hanaivincag sland uysieze 195 
RPG Ii Combo A/ four items below ........... New Version 1400 
RPG Ii Compiler No Royalties ............. New Version 750 
Screen Design Aid Utility for RPG I... 350 
SEU Source Entry Utility ........ccccccccees eects 250 
NNN chic 088 inet stcsasanss hn Aipoxersese 250 
Text Management Utilities 0... ee 120 
logitech products 
LOGIMOUSE BUS with PLUS Pkg by LOGITECH ........... 119 
with PLUS & PC PaintDrusn............ccccscccceseenseseeneens 149 
with PLUS & CAD SOPtWAME .........ccceecceteceteeeeeeeeeeeens 189 
WIT PLUES © CAD & PAM 00s. s00sskcdscsnsocneescavanses 219 
With PLUS & First PUDISNEL .....:.....ecscecsssssesesseneesees 179 
LOGIMOUSE C7 with PLUS Package ..........c0cceceee 119 
Wit PLUS &'PC PORMDIUSN .....csscceesvecveceroeserdvescenees 149 
with PLUS & CAD SOPtWALE ........cceeceeteeeeseeteeeens ees 189 
WT PLES GS IGAD BPD... ove dBieescedtectiisemasensoserrsaes 219 
with PLUS & First PUDIISNOL .........0cc00 ceceesseeeeeeeeees 179 
LOGITECH Modula-2 Development System ............ 249 
Modula-2 Compiler Pack.................0.00::eee 99 
TS Se ns rie ee eee 169 
meridian products 
AdaVantage GSA-validated ..........ceccccceeereneeeees Sale 795 
SDE COPIER | so 2s iss ms akarentigo vente aes New, Sale 995 
AdaVantage Debugger.................ceeeeee New 495 
AdaVantage DOS Environment Package................. 50 


45 
45 


115 


199 
199 
139 
139 


199 
299 


99 


47 


111 
47 


69 
125 
155 
249 
125 


85 
85 


265 
495 
37 


179 
119 

85 
169 
159 
318 


1184 
138 
1099 
625 
309 
199 
199 
88 


98 
119 
153 
179 
139 


119 
153 
179 
139 
199 

75 
139 


675 
879 


47 


AdaVantage Utility Packages ......0...0.0..ccee 50 
metagraphics products 
MetaWINDOW Wo Royalties .........0.cccccccsceseesessestesen 195 
MetaWINDOW/PLUS o.oo... cece 275 
QuickWINDOW/C for Microsoft QUICKC .......c.c.cccccccsess 95 
TurboWINDOW/C for Borland Turb0 C........ccccececeeeeees 95 
TurboWINDOW/Pascal for Borland Turbo Pascal.......... 95 
microcompatibles products 
| eR ie SABRE conf «0 a 135 
cass sa csvssisns pre eee eosin sida. 295 
bf ae eran MIIT Ee 2 ORGS. e Ghee aE 195 
1 Seeman 4 (rte DA eae: CH Lenn Se 135 
| nn lis ee AA Ae ar oe 135 
microport products 
DOSMerge286 Specify 2-Users or Unlimited .............. 149 
DOSMerge386 2-USerS ..........c.csceecsssescetsseeeeeteeees 395 
DOSMerge386 Unlimited USES .........c.cccccccececeseeeees 495 
System V/386 Combination ...............0...0cccccccee 799 
386 Runtime System ..............0c cece 199 
386 Software Development System .................. 499 
Text Preparation System ..............0.0cccccceeee 199 
System V/AT Combination .................:ccceeceeeeeees 549 
AT Runtime System ...............0ccccceeeeeeeeees 199 
AT Software Development System .................... 249 
Text Preparation System... 199 
AdaVantage Compiler 
by Meridian Software 


List $795 Ours $735 
with Optimizer: 
List $995 Ours $879 


microsoft products 


Microsoft BASIC Compiler for XENIX..................00006. 695 
Microsoft BASIC Interpreter for XENIX..................004. 350 
Microsoft C Compiler 5 w/CodeView..............0:0c000 450 
Microsoft COBOL Compiler with COBOL Tools ........... 700 

- f._ RRORRET ONE tee Oe er 995 
1 Sen ai ey i ee nea ee 495 
Microsoft FORTRAN Optimizing Compiler................... 450 
Microsoft FORTRAN for XEMIX ............ccccceseeereeeees 695 
WUCImIT C esis cis nace lcedenseus sede New 495 
Microsoft Macro Assembler.......................0000000 150 
Microsoft Mouse with Paint & Mouse Menus .............. 150 

with Microsoft WindOWS & Paint ......ccccscecceseereeee 200 

EE cau caletsetscasbanwncdant lao deratontded acess 175 
Microsoft Pascal Compiler...............0.....ccccceeee 300 

RR ood steak oe dates Na nesses cette 695 
Microsoft QuickBASIC .................cccccccceseescseeeeees 99 
NN ices rcs rateiosdngien spies urs; 99 
IGG si eich AR Beis ccitesvnesetsss 99 
Microsoft Windows 386..........0..0.0..ccccecseeeeeee 195 
Microsoft Windows Development Kit ..................... 500 
Weir htc in Rain cm.. 450 
RI PHOTON soos stckeckcctsh dos ieles saiehecanne ottesiaen 195 

mks products 
LGR Reals OT Mia 75 
MKS RCS Revision Control SySteM ...........cccesceeeees 189 
MKS Toolkit with MKS VI EdmOF ..........cceeccceeeteeeees 139 
MKS Trilogy with AWK, CRYPT & Kom Shell.............0++. 119 
NOME Vi Era DY INS...2.0.. oie 75 
novell development products 

Btrieve /SAM Mor with No Royalti€S..........ccccccceeeeeees 245 

MOV! QUELY. UlHlity oo... ecisccssieiiisccsessesescenesseseseees 245 

Report Option for Xtrieve..........cccceccereeeenenees 145 
Btrieve/N for NEtWOLKS .......ccccccscsescssseseesesssesseseeeeeees 595 

UN 2a sss 6200, os apatcbende AP cag cet sears sscancehioks 595 

Report Option/N for Xtrieve/N .........cce cece cee 345 
“STINGS Rae fe, te tu nia ee he ae 795 

peter norton products 
Advanced Norton Utilities... eee 150 
Norton Commander by Peter Norton .................0600 75 
Norton Guides Specify Language .............c0ccccsceees 100 
Norton Utilities by Peter NOON .............ccceceeeeeeee 100 
phoenix products 

Pasm86 Macro Assembler version 2.0..........c.c0ceceee 195 
Pdisk Hard Disk & BaCkup Utility .........c.cccccceeteseeenees 145 
Pfantasy Pac Phoenix COMDO............cccccceeesessesesees 995 
Pfinish Execution Profiler .........:.cccccccseccessceeeseeeeeesee 395 
Pfix86plus Symbolic DEDUGGES ...........:ceeeereeeeeeees 395 
PforCe Specify C COMPIICL.............:ccseseseseseseseesees 395 
PforCe+ + Specify C Compiler and C++ 00.02.0000 395 
Plink86plus Overlay LINKEL...........:.ccececeseseeeteeeeeeeeeees 495 
Pups AlN UMN 52s nsn ct Bc nogeodeneerctincenaesee 125 
PHGMOG ARIE Tord EOIN. 55.52.00 cccicece css cassescnessnensies. 195 
PEN CN cso woes casttbn se een scentdowenihgans 295 


47 


159 
229 
79 
79 
79 


117 
265 
175 
117 
117 


129 


429 
669 
169 
429 
169 
465 
169 
209 
169 


The AdaVantage Compiler is a fast, efficient, production-quality 
Ada programming capability fully validated by the U.S. Depart- 
ment of Defense. It generates native 8086 code in Intel stand- 
ard object format. Includes: compiler, linker, library mgmt. 
tools, support packages, runtime libraries, and a configuration 
tool. The optional Optimizer offers code improvements rang- 
ing from local optimizations to global subprogram removal. 
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TurboGeometry Library 


TurboGeometry contains over 150 routines that perform 
geometric calculations. Topics include: intersection ‘of lines, 
arcs, circles and planes; finding coefficients of line equations, 
planes and circles; distance between points, lines, circles, 
arcs, and planes; decomposition of polygons; 2D/3D transfor- 
mations; 2D/3D curve generation, vector computations; con- 
vex hull computations; and much, much more. 
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believe that the pace of change in 

programming methodology is in- 
creasing, and that those who learn 
new paradigms will keep up, while 
those who do not will be left behind. 

I am encouraged in this belief by 
a rereading of Robert Floyd’s accep- 
tance lecture on receiving the 1978 
Turing Award. Floyd contended 
then that “continued advance in pro- 
gramming will require the contin- 
ued invention, elaboration, and com- 
munication of new paradigms.’ 

Floyd took the term paradigm 
from Thomas Kuhn's The Structure 
of Scientific Revolutions and used it 
to refer to general models of prob- 
lem solving and_ the _ shared 
conventions and traditions of a dis- 
cipline. Structured programming is 
a general paradigm, recursion a nar- 
rower one. 

In his lecture, Floyd described 
how he invents new paradigms. 
Having solved a problem, he next 
resolves the problem from scratch, 
then looks for the general rule for 
solving problems of this sort, ulti- 
mately deriving a broad problem- 
solving paradigm. ‘Most of the clas- 
sical algorithms to be found in texts 
on computer programming can be 
_ viewed as instances of broader para- 
digms,” Floyd said. “Simpson’s rule 
is an instance of extrapolation to the 
limit. Merge sorting is an instance 
of the divide-and-conquer paradigm. 
For every such classic algorithm, one 
can ask, ‘How could I have invented 
this,, and recover what should be 
an equally classic paradigm.” 

And that’s what you need to do if 
you want to advance the field and 
your place within it, according to 
Floyd: “I believe that the best chance 
we have to improve the general prac- 
tice of programming is to attend to 
our paradigms.” 

I believe that attending to our para- 
digms is more imperative today than 
a decade ago, for two reasons. 
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First, there are simply more para- 
digms that we must understand 
today. Consider this list of vogue 
topics: logic programming, produc- 
tion systems, expert systems, black- 
board systems, functional program- 
ming, object-oriented programming, 
event-driven programming, neural 
nets, associative memory models, ma- 
chine learning paradigms, MIMD, 
SIMD, and data-flow programming. 
Many of these topics overlap and 
some may be synonyms, but how 
many programmers can sort them 
out? Or predict which will be impor- 
tant two years from now? 

Second and ultimately more far- 
reaching, I believe that a very deep 
paradigm, the Von Neumann model 
of sequential processing, is in the 
process of being supplanted by 
many parallel-processing paradigms. 
If this is true, it will be the most 
fundamental change in program- 
ming since the development of high- 
level languages, and it will radically 
affect the way we think about the 
process of writing software. With cer- 
tain limited and constrained excep- 
tions, all software is written within 
the Von Neumann paradigm. As pro- 
grammers we scarcely know how to 
think in parallel terms. Our algo- 
rithms will not transfer. We will 
need a paradigmatic approach in 
order to find our way in a parallel 
world. 

The parallel world is bigger, and 
hairier, than the sequential world. 

True, there are grounds for skepti- 
cism about parallel processing. 
There is no architectural platform 





for parallel programming outside cer- 
tain specialized areas, such as nu- 
merical analysis and graphics. The 
kind of parallel processing I am talk- 
ing about—multiple instruction, mul- 
tiple data (MIMD) programming—is 
difficult, with significant unsolved 
problems. 

True, there is no parallel equiva- 
lent of the IBM PC. But desktop 
multiprocessor architectures based 
on the transputer chip exist as com- 
mercial products today; they are just 
not yet cost-effective. The biggest 
cost factor is the price of the 
transputer, which is a function of 
demand and competition. This bar- 
rier could start falling within the 
year. It is not too early to imagine 
what you could do with a true paral- 
lel-processing system. 

True, decomposition of a problem 
into MIMD parallelizable compo- 
nents is hard. That is precisely why 
a paradigmatic approach is neces- 
sary: finding the right paradigm can 
give you the solution to a broad 
class of problems. The divide-and- 
conquer paradigm, for example, is 
well adapted to MIMD paralleliza- 
tion, so if you can cast your problem 
in that form, you should be able to 
find a good parallel solution. And a 
good parallel solution is one that 
increases throughput radically. 

I believe that the most successful 
programmers in the next decade 
will be those. who carry in their 
toolkits, among their shiny metric 
and nonmetric algorithms, a rich set 
of paradigms. 
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A PASCAL COMPILER 

You can program as much as you want in ISO Standard Pascal, or use the 
powerful extensions we’ve added to this production quality compiler. And 
you get complete integration with C and assembly language as well. 


Working together, the 68K Cross Development Tools deliver both 


optimized performance and improved programmer productivity. 
Best of all, Whitesmiths offers everything you need at a very com 
petitive price. We’ve been delivering and supporting high quality 
software development tools since 1978, and we’re committed to 
continually enhancing our product line. 


If you develop 68000 programs on a DEC VAX, an IBM PC, ora 
UNIX workstation, chances are we can save you time and money. 
For more technical details, call our toll-free number today. We also 
offer attractive packages for OEMs. 





















Whatever dialect of IBM you need to speak, 
CROSSTALK® Mk. 4 makes the connection. 


Now, one program does the job that used to require several. 
CROSSTALK® Mk. 4 allows high-speed direct communications 
between PCs and minicomputers, or (with an IRMA™ board) 

between your PC and an IBM Mainframe, or (with Smart Alec™) 
between your PC and IBM System 3x’s. If you like, CROSSTALK 
can support all of these sessions (and others) simultaneously, 
and display each session in its own window. 

CROSSTALK Mk. 4 emulates all the terminals you’re likely 

to find useful. That includes IBM 3101 (page and character 
modes), IBM 525x, IBM 529x, IBM 327x, as well as many 
popular async terminals like the DEC VT 100 and VT220 

series. CROSSTALK Mk. 4 includes the powerful CASL™ 
programming language, which allows you to automate 
communications applications quickly and easily. 

So if you're used to thinking of CROSSTALK just to 
use with a modem, you're missing some important 
connections. Ask your dealer for details, or write: 


Digital Communications Associates, Inc. 
1000 Holcomb Woods Parkway / Roswell, Georgia 30076 
1-800-24 1-6393 


CROWTALK 
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